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A new generation of Color Computer products 



V-Term Terminal Emulator (im or 512k o>co m omy) 444 improved! 

V~Tera is one of the nsost itdVanced terminal programs for the CoCo 111 everttf 

FEATURES: VT-100, VT-52, Vtdtex(tocludes RLE graphics display), and standard CRT emulations. Full use of 512K, 
80X28 text or graphics characters, Windows & Multi-tasldrijstDisk Basic!), RAMDISK like buffer, Xmodem, Xmodem- 
CRC, Ymodem, Xou/Xoff. Monochrome monitor support. Capture buffer, Snapshot, Conference mode, Serial/RS- 
232/DCModem Pah, 35/40/80 Tracks, Over 56 pages of docst Disk , $39.95 Ver 02.00.00 upgrade ; $6»?5 



MAX-10 (CoCo HI only) The dazzling Word Processor and document creator for the CoCo flit 
MAX-10 fa the perfect partner for CoCo MAX HI! Mix graphics and text to get great looking newsletters, 
flyers, term papers, ect... MAX-10 .... 179.95 CoCo Max III .... $74.95 or buy BOTH for $139.95 and save! 



MAXSOUND (mk or 512k coco m oniy> See June '88 review 

Turn your CoCo HI into a REAL digital audio sampler with HIGH quality audio reproduction. Easily add exotic effects, 
ECHO, stuttering, speed shifting, sequencing, and reverse audio to BASIC or ML programs or GRAPHICS! Now 
includes Data Compression. Imagine recording any Voice, Music, or Sound effect and befog able to use these DIGITAL : 
recordings In your own programs! 3 disk Sides Includes: INTERFACT/B1N - ML driver for sound effects. G&M/BAS - 
Adds sound effects to Graphics. SHOWTIME and DEMO disks. SCOPE/BAS - Turns CRT into a Digital Oscilloscope 
to look at MAXSOUND waveforms, CALL TO HEAR 'OVER THE PHONE* DEMO *59.95 



MAXSOUND SOUNDTRACKS W / GRAPHICS (MAXSOUND program NOT req'd) Call for Titles .... 55.95 



GRAPHICS-25 (512k CoCo III only) Great with MAXSOUND and/or CoCo Max Hi! 

UtJlite the FULL 512k memory range of your CoCo III from BASIC for graphic*! Create up to 25 ONBOARD HIRES 
SCREENS! Six new BASIC commands allow instant display «witr.hi»g while secretly drawing other screens. Save and 
load screens to and from disk. Copy one screen to another. Fast Graphics action, Smooth animation, and 100% 
Machine Language code. Requires DECB 1,0, DECB 1.1, or FKEYS W, Complete with documentation. Disk 



MULTI-LABEL 111 (CoCo HI only) See Jury '87 Teview. An easy to use, versatile label creating program 
including many new CoCo III features. Print multiple fonts on each label! Disk $16.95 



m (CoCo l/n/in) $ee April '87 review. A user friendly, user programmable function key utility that 
creates up to 20 function keys. Includes an -EDITOR, DOS mods, DISABLE, and It's EPROMablel. Disk $19.95 

SLXDRIVE (CoCo l/fl/lll) This machine language utility modifies DECB 1.0, 1.1, FKFYS III, or ADOS to 
allow the use of 3 double-sided drive* (or 2 D/S drives and J&R » RAM DISKS) as 6 S/S drives. Disk .,,$16,95 



AUTO DIM (CoCo III only) See Jan. *88 review. This hardware device protects your monitor, or TV from 
IMAGE BURN after a few minutes of Inactivity from your keyboard. Illustrated and easy to Install. Hdwe $29.95 

MPI-CoO) Locking Plate (CoCo HI only) Now 2 styles Protects your CoCo ID and MuW Pak 
Interface from destroying each other! Please specify MPI number 26-3024 or 26-3124 when ordering! Only $9.95 



In Quest of the Star Lord (CoCo ill only) Enjoy the mixture of science and fantasy 

quest for the Phoenix Crossbow, the only thing that can save you in the post-holocaust world. 4 Disk 
of animated graphics adventure! Outstanding 320x200 graphic,! Disk $34.95 Hint Sheet $3.95 



as you 
sides 



Kun g-Fu Dude (CoCo 1/n/IU) See Feb. '88 review. A Kung-Fu program for the CoCo. Destroy opponents 
and evade obstacles as you grow even closer to your ultimate objective! Disk „,„,..„....,,.............. $24.95 

FYRAMIX (CoCo III only) See Dec. '87 review. Brilliant colors, sharp graphics, and hot action! Disk .. $19.95 

AD&D Character's Companion (CoCo 1/B/TU) Great trmesaving 

?mpatible AD&D characters. Includes dice rolling routine, pick ability, Tace k class. Buy 
magic items & spejl materials. Save, load, and print character tofo. 3 Disk sides $24.95 




White Fire Of Eternity (CoCo l/fl/lll) See Dec. '86 review. A great graphics adventure! Disk.. $19.95 

CHAMPION (CoCo 1/U/m) See May '87 review. Become a superhero fa this action adventure! Disk.. $19. 95 

Toll Free 1^80(M4l-GIME Order line 

Technical assistance: 7pm to 9pm GIMMESOFT Add $3.00 for shipping and handling 

Orders: 9am to 9pm Eastern time P.O. Box 421 Add $2.50 for COD (USA only) 

On line orders and up to date Perry Hall, MD 21128 MD residents add 5% sales tax 

Information: Delphi's CoCo Slg 301-256-7558 or 301256-2953 VISA /MC/ Check/Money Order/ COD 
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First things first - a Happy Thanksgiving 
to all of our readers everywhere and a very 
Merry Christmas and Happy Chanuka as well. 

Second, my apologies for being as late as 
we are with this edition. A number of 
advertisers, unable to get space in another 
CoCo magazine, asked us to make room for 
them. Knowing our readers are always looking 
for a good buy we said "sure." In addition we 
were also informed that "InterTan" (Tandy of 
Canada) will no longer be ordering CoCo 3's. 
We have received many letters from CoCo 
owners in Canada mentioning this to us. I 
spoke with Fran McGehee of Tandy and she said 
that this was solely an InterTan decision and 
that it in no way affected the CoCo in the 
U.S.A. She said that Tandy was fully behind 
the CoCo here in the States. Canadian CoCo 
owners who want to contact InterTan will find 
them in Barrie, Ont . The area code is 705. We 
urge you to write to let them know your 
feelings. Remember that you can catch more 
flies with honey than vinegar. 

Other than that bit of bad news a LOT has 
been happening with CoCo Clipboard Magazine . 
We were the guests of the CoCo section of the 
Philadelphia Area Computers Society in 
September. Our thanks to Paul Sgrillo and his 
family for opening their home to us. Also our 
thanks to Bob Hengstebeck for making the 
arrangements and too the folks who attended 
the meeting at LaSalle College. Our thanks as 
well to Paul and Kathy Bornemann in Trenton, 
NJ for their hospitality on Saturday evening. 
Paul has written a couple of articles for us 
and is a very active business user of his 
CoCo ' s . 




Dar draws a name for a free 
subscription . 

October found us visiting many of you at 
the Hyatt Regency in Princeton, N.J. In 
particular our thanks to Tom and Jason of 
CoCo Tech for all of their help. Be sure to 
4 



check their ad in this issue. Also joining us 
was Jim DeStafeno and Ed Gresick of Delaware. 
Jim produces ClipDisk and Ed, who is using 
the CoCo to operate his Radio Shack franchise 
store, answered questions about programming 
and about the CoCo in general. Our thanks to 
all of you who stopped by and said hi. 

You may have noticed the number of our ads 
has increased. We can't thank our advertisers 
enough for their support. We can't urge you 
enough to support these hard working men and 
women as they support all of us with their 
hard work. And use those Clipboard coupons, 

We've been asked several times if we 
would open a "Classified Ads" section in the 
magazine. We have resisted this for some time 
for a number of reasons. However more and 
more people have asked for this service and 
so we will open up a "Classified" section. We 
will be monitoring this experimental section 
very closely. The last thing we will tolerate 
is stolen merchandise and that includes 
pirated software. We reserve the right to 
refuse any ad and we will not take ads for 
x-rated, porno, or lottery/ganbl ing software. 
Details are as follows: 

A) - All ads must be pre-paid in full. Check, 
money order or credit card. Credit card 
orders will be billed at 10% surcharge. 

B) - Ads are 50 cents a word with a 10 word 
minimum. Subscribers of record may take ads 
at 40 cents a word with a 10 word minimum. 

C) - Ads must be typewritten. They must be 
contain the name and full address of the 
advertiser and we must have your phone number 
for confirmation of your order. 

D) - CoCo Clipboard Magazine will not be 
liable in any way for items advertised in the 
Classified section. There are no refunds on 
these ads. 

E) - Classifieds are open only to private 
individuals or groups. Commercial ads will 
not be accepted. 

This will be a limited 2 edition 
experiment. If we don't have any major 
problems we will continue the service. 

Hope this finds you all well and having 
fun, producing and learning. Have a Happy New 
Year and we'll see you all in 1989. 




"Software for your horn? sine* 1983" 



1328 48th St. 
Des Moines, IA 50311 
515-279-2576 



TERRY SIMONS' 
Compu ter Villa 

PRESENTS 

"Home-Pac 3.2" 
F>A>S>T C>H>E>C>K/CARD & MAILER 
+ 

DISK JACKET 




128K, Disk 



RGB or Cornposit Monitor Req 



Rush Caley of Emerson Computer Services says:"/ have 
seen countless checkbook programs -for the CoCo. Some Mere 
commer icial ly avai lable , others were written by users -For 
their own use. In a word f I have NEVER seen a program -for 
this purpose as good as Terry's Home-Pac." 



1. Full 80 Column - large amount of data displayed 

2. Credit-Card & Checks - Constant balance - two accounts 

3. V3.2 has "prompt cards" making it easier then ever 

4. Full sortability Plus - date parms - printer dump 

5. Nailer Program & Disk Jacket Program - 70K+ CoCo Power 

6. Make your CoCo a useful part of your house! 

7. Home-Pac is "Satisfaction Guaranteed"! 

See August Clipboard Review. S3 A- . 9 5 

Any order $2,50 Shipping *FREE Christmas Disk with any order! 

F3 ^/ Bob Van der F»C3€=»1 All 32K CC2 or 3, disk Req. 

1 . Magazine A r t icle Fi nder; , Do you have over a year of Coco 

Magazines? If you have one year or several years of CoCo magazines, 
"Indexer" will find article you want FAST! Telling you the name and 
month of the issue. Total of six years, including 1988. Covering over 
5 CoCo Mags, including "Clipboard", and Rainbow of course. Over 200K of 
compressed data! (Two Disksfull). Plus it's a great a great magazine 
article indexer for; "any type file you'd like to create"! $21.95 
Three, first class Programming Tools! 

2. Disk Programming Pak_L 4 routines a. ADDML appends ML routines to 
basis b. UNPACKER Undoes basic Packed programs c. MLBASIC Converts a 
basic program to ML format to be LOADMed & EXECed. Encryps & BREAK 
protects, preventing others from viewing or altering your code d. JOIN 
Joins several ML routines, and/or adds auto-exec, if desired. $14.95 

3. PACKER: Removed REMed statements redesignating line No's. Removes 
spaces tokenizing basic to a more compact form. Joins lines up to 2K 
long! Five packing functions in all. +error checking $14.95 

4. M A PPE R : Cross-references all Variables & Strings + GOTO's & 
GOSUB's, by line No. & occurance times. Screen/Printer display. $14.95 

Van der Pool Uti 1 ities 

5- Disk Mana gement Sysismj. Auto-Program filing system also keeps 

copies of (and restores) disk directories. $14.95 

6. Disk Uti lit y Pack II: Superfast - Format Backup 3 or less swaps 
per 64K system. Utilizes from 32K to your maximum 64/1 28/51 2K! Plus 
Find; Compare; Diskmatch; Occount; MENU 16 programs in all! $14.95 

7. BVDP Stock Manager $19,95 8. BVDP "CoCo Three" CMbage S 1.1.9* 



Computer Villa, Chr i s -t m a s Graphic ' s & Oarols 
Graphics by Terry (g) Simons, are presently used by several 
Top Software Co's. The Christmas disk Specify CoCo 2 or 3. $4.95 




The Machine Shoppe 



Andrew Bartels 



Have you tried to get started programming 
in Assembly, but not gotten very far? If 
you're used to BASIC programming, Assembly 
does have a complex look to it, and chances 
are there are MANY other CoCoists out there 
wondering about answers to the same Assembly 
questions you are! That's why CoCo Clipboard 
is printing my column, The Machine Shoppe - 
to answer your questions. So if you've got a 
problem dealing with Assembly, no matter how 
small or how big, drop me a line. I'll see if 
I can help you out in The Machine Shoppe. 
Mail your Assembly questions and troubles to: 

Clipboard Machine Shoppe 
c/o Andrew Bartels 
1859 East 8th Street 
Mesa, AZ 85203-6649 
Phone: (602) 827-1934 

If it's an emergency, and you just have to 
talk to me right away, I've included my 
"Assembly Questions Hotline" phone number 
here as well. Remember, no question is too 
big or too small. I look forward to hearing 
from some of you soon! Meanwhile, here is 
this two month's worth of questions and 
answers : 

Q: What are the "Condition Codes"? I know 
they have something to do with the CC reg- 
ister, but since I'm Just starting Assembly, 
I'm not sure what they do. 

Troy Gresick, 
Springfield, Illinois 



A: The Condition Codes are a series of eight 
bits in the CC register. Those eight bits are 
called "Condition Codes" because they change 
often, and reflect the results of the last 
operation performed by the computer. A map of 
the bits in CC, along with what thev do is in 
Table 1. 

How do they work? Well, suppose you have 
written Assembly code to do a subtraction of 
two numbers. The result of that subtraction 
is recorded in CC . If the answer to the sub- 
traction was zero, the "Z" bit of CC would be 
set (equal to one). The "N" bit of CC is set 
only if the result is negative. In the above 
example, "N" would be clear (equal to zero). 

The "V" bit is set when an overflow 
occurs, such as when you add 70 and 200 



Table 1: Bit Map of the Condition Code Register { CC ! 
Bit Name Description 

0 C Carry Code, for carry and borrow 

actions of adding and subtracting 

1 V Overflow Code, set when you over- 

flow a register (like adding too 
much ) . 

2 Z Zero Code, set when two values are 

equal or a subtract equals zero. 

3 N Negative Code, set if one value is 

less than another, or if subtract 
results in negative number. 

4 1 IQR Interrupt flag, clear when 

CoCo is on an IRQ interrupt call. 

5 II Half Carry, to carry out of bit 3. 

6 F FIRQ Interrupt, clear when CoCo is 

on a Fast Interrupt Request. 

7 E Entire State on Stack, to tell 

what a Return From Interrupt (RTI) 
does . 

together, and try to keep the answer in only 
eight binary bits. The "C" bit is likewise 
set when there is a need to carry or borrow 
in addition or subtraction. Other bits in CC 
deal with coordinating the system interrupts 
so the machine does not lock up. 

The relative branch instructions are prime 
examples of how you can make branches in your 
programs according to the conditions re- 
sulting from various tests. The BEQ in- 
struction stands for ''Branch if Equal". The 
branch actually occurs when the "Z" (zero) 
condition code is set. The computer performs 
a subtraction when it compares things, and a 
subtraction of two equal values will result 
in zero. So, you branch when two numbers are 
equal, the BEQ relies on the "Z" condition 
being set. The other conditional branches 
work in this manner, except with different CC 
register bits. 

chapter 6 of TRS-80 Color 
Language Programming, by 
for more on how these 
the Condition Codes. You 
be a very important part 



Take a look at 
Computer Assembly 
Bill Barden Jr. , 
branches work with 
will find them to 
of Assembly. 



Q: I've been having trouble doing 8-bit 
signed multiplies . Fortunately , the 6809 in- 
struction set has a MUL instruction that does 
8-bit multiplies. But this is UNSIGNED. Is 
there a way to get signed values from it? 

Arlin Parsons, 
Naples, Florida 



A: I'm sure you must then be familiar with 
the convention for signed numbers in binary, 
where the highest order bit determines the 
sign (one is negative, zero positive) instead 
of carrying a value. To get a signed multiply 
out of an unsigned one, Just regard the high 
order bit as a sign, and not as part of the 
number . 

First, the binary operation called Ex- 
clusive OR is what we can use to determine 
the resulting sign when the numbers are 
multiplied. Table 2 shows the truth table for 
Exclusive OR, in both binary, and in plus and 
minus signes (as it applies to mathematics). 
The listing of SMULT . ASM below shows how to 
do the signed multiply you asked about. Lines 
110 to 140 get the resulting sign bit into 
bit 7 of a byte and push that byte on stack. 

Table 2: Exclusive OR Truth Tables 



Binary 
! 0 1 



Number Signs 



0 ! 

1 ! 



Lines 150 through 170 actually multiply 
the numbers to get the unsigned result. Now 
it's just a matter of clearing out any high 
order bit from the answer (taking it's ab- 
solute value) and then applying the sign bit 
we had saved earlier. Line 180 performs the 
absolute value, and line 190 logical OR's the 
sign byte on stack with the most signif- 
icant byte of the answer. Since the sign in 
the sign byte is bit 7, and all other bits 
will be clear, we can easily put the correct 
sign on the answer with line 190. 

Line 200 cleans up the stack, line 210 
saves the answer to memory, and from there 
line 220 returns. It's that simple. You can 
always do this on signed numbers, regardless 
their size (assuming the size does not exceed 
the number of bits you are working with). 
This will even work on signed divides too. I 
hope this fixes the problem. 



Q: I am a proud CoCo 2 owner, and up until 
now, I've had a cassette only system. I got 
into Assembly with the EDTASM+ program pak. I 
Just got a new disk system, and was thinking 
it'd be interesting to see how to do disk 
I/O. Some Assembly appl ications Just need 
that available . 



Pave Hillis, 
Seattle, Washington 



A: You may have heard that disk I/O is much 
harder than cassette I/O. That's true, 
especially if your Assembly program commun- 
icates directly with the upper memory I/O 
bytes devoted to disk access. But that is 



much too involved to discuss in a Q&A column 
such as this. Fortunately, TANDY provided us 
with a much easier way for this which is 
explainable quickly. It deals with a ROM 
routine called DSKCON. The address where 
DSKCON can be found is always, and will 
always be contained in ROM addresses $C004- 
$C005. The pointer to the parameter bytes for 
DSKCON operation is at $C006-$C007. All you 
do is LDX $C006, and X will point to the 
correct place to store the necessary five 
parameters . 

Assuming you've done a LDX $C006, the 
following parameters are as shown in Table 3, 
relative to X. The first parameter is what 
operation you wish to perform. By putting a 
zero at the location referenced by ", X" you 
tell it to restore the drive read/write head 
to track zero. A code 1 there means no op- 
eration, 2 tells it to read a sector, and 3 
instructs it to write a sector. 

Now, the next step is to select the drive 
number. If you just bought a new disk system, 
you probably only have one drive to access, 
which would be drive number zero. But CoCo 
can support up to four drives (numbered 0-3). 
The drive number goes here at the address 
referenced by "1,X" (called DCDRV ) . 

From here on, the parameters only need to 
be selected if you chose operation code 2 or 
3 for DCOPC (read and write, respectively). 
This next value is referenced by "2,X", and 
is called DCTRK. It selects the disk track 



=— = PRODEK SOFTWARE =— = 



c/o Hike Snyder, Rt. 2, Box 81, Allen OK, 74825 

Adventures are supplied on Disk Only, but are 
transferable to tape. All are text only. CoCo 1, 2 
and 3 compa table. 

Clipboard SPECIAL =-= 

With any order of 3 or more, you may choose a free 
program with the coupon on the coupon page! 

Here's our 11ne-up 

S HADOW WORLD Travel to the future! 
TREASU RE SEARCH Find King Erik's Treasure! 
ASTE R OID B7 Escape from an Asteroid! 
DESTINATION: UNKN OWN You are stranded! 
R0B0CR00K Catch the mechanical menace! 
COUN TRY CLUB Get There 1n Two Hours! 
SILE NCE SYN DROME Find the Secrets of the Cloud! 
ANO THER DIMENSION Escape to Another Time! 

Plus more being created Every Day! 

Please note: More than one game may be sent on theft 
same disk on orders of two or more. 



Just $12. 50 for each game ordered 






If You Are Serious About Stocks. 
This Program Is A Must! 



Stock Market portfolio for the color computer 
will keep track of all your current slock listings 
and keep a listing of stocks you have sold by the 
year, they were sold with all totals, profit and 
loss, and percentages. More than one person 
can use this program as long as the first three 
letters on both first and last name are not the 
same. The program is menu driven and will 
give you the option for either screen print or 
information to be printed on printer. 



Rush Check for $22.00 plus $3.00 shipping & handling to: 
Paparis Enterprises 

700 York St. 

Williamsburg, VA 23185 
Please allow 2-3 weeks for delivery 
Sorry no CO.D.S 
VA residents add 4.5% sales lax. 
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number involved. The disk is divided into 35 
tracks, so select anything from zero to 34 
here . 

Table 3: DSKCON Routine Parameters 



Name 



Relative to X, 

if You LDX $C006 Description 



DCOPC 


,x 


Operation Code: 

0 = Restore to 

track zero. 

1 = No operation 

2 = Read 

3 = Write 


DC DRV 


i,x 


Drive number, from 
0 to 3 . 


DCTRK 


2 ,X 


Track number, from 
0 to 34 


DCSEC 


3 ,X 


Sector Number, from 
1 to 18 


DCBPT 


4,X 


Address of 256 byte 
I/O buffer. 



Next is DCSEC, referenced by "3,X", lets 
you select the sector number. Each disk 
sector contains 256 data bytes, and there are 
18 of them on each track. So, choose a value 
from 1 to 18 to store here. 
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**************** ****** ********* 

Sample Menu: 

Hard Disk Organizer SvbUw 

1. Development of Kilos 

2. Busi. & Word Processing 

3. Communi cat ions Programs 

4. Exit 

******************************* 



The H.D, 0 . p rogram i s avai lab I e from : 
Bob Hangs tebvck, 108 Urandv lew Ave., 
Feasterv tile, PA 19017, (215) 822-5155 

H.D A), is Just $21.95 f $8.00 shipping and 
packaging. 



And lastly, we have DCBPT, referenced by 
"4,X". Here is how you tell Disk BASIC where 
your I/O buffer is located in memory. If you 
are writing, this is the address of the 256 
data bytes that go out. If you are reading, 
this becomes the address at which Disk BASIC 
stores the 256 data bytes it reads from the 
disk . 

Once you. finally get done setting the 
parameters needed to specify what operation, 
what drive, where at on the disk, and where 
at in memory, you are ready to call DSKCON. 
To call it, just JSR ( $C004 ] . That jumps to 
the subroutine whose address is contained 
within $CO04-$C005, where DSKCON' s address is 
stored in ROM. 

After you have called DSKCON, either what 
you told it to do is done, or things were 
aborted due to an error. So, you need to test 
out the error status report referenced by 
"6,X". It is called DCSTA. If that byte is 
zero, no errors have occured . If some bit or 
bits in here are set, you've had some kind of 
error. Table 4 lists out the definitions of 
each bit of DCSTA. When an error happens, 
you'll have to provide the necessary routines 
to report the error. 

Okay, now we know how to get one sector 
loaded in or written out. What about some- 
thing more complex, like doing a DIRectory? 
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Table 4: DCSTA bit definite 



Well, we just use a series of DSKCON calls to 
read the directory, and from what we read in, 
we can then display a list of what's on the 
disk. The DDIR . ASM listing provides an ex- 
ample of how a double column direcory can be 



printed to the 
DSKCON calls are used to 
information. 

This has been a 
disk I/O. Another 
Assembly disk I/O is 
your disk system 



I how the repeated 
get the directory 



DCSTA is r< 
LDX $C006. 



Bit 



6,X, where 
lef initions 



will help 
necessary 
DDIR. ASM 
di rectory 
how to us( 
the rest 

P3 



fairly brief overview of 
version of explaining 
written in chapter 11 of 
s manual . That too 
your way to building the 
tines you'll need. The 
listing is a complete 
and it will help you see 
DSKCON to do the disk I/O while 
of your program controls the 



Lost data 
CRC of 
Desired 
Write fault 
Disk it 
Drive not 



t't 



right 
founc 



I/O 



Listing of Sh 
00100 

00110 SMULT 

00120 

00130 

00140 

00150 

00160 

00170 

00180 

00190 

00200 

00210 

00220 

00230 VALUE1 
00240 VALUE2 
00250 RESULT 
00260 



JLT.AS 

ORG 

LDA 

EORA 

AN DA 

PSHS 

LDA 

LDB 

MUL 

ANDA 

ORA 

LEAS 

STD 

RTS 

FCB 

FCB 

FDB 

END 



$EO0 

VALUE1 

VALUE2 

#$80 

A 

VALUE1 
VALUE2 

#$7F 

. S 



0 
0 

SMULT 



GET ONE VALUE 

FIGURE RESULTING SIGN IN BIT 7 

KEEP ONLY BIT 7 

SAVE SIGN BYTE FOR LATER! 

GET ONE VALUE 

GET OTHER VALUE 

DO UNSIGNED MULTIPLY 

GET ABSOLUTE VALUE (CHOP OFF HIGH BIT) 
PUT PRE- FIGURED SIGN ON IT 
CORRECT STACK 
SAVE RESULT 
AND RETURN 

FIRST 8 -BIT SIGNED NUMBER 
SECOND 8-BIT SIGNED NUMBER 
SIGNED ANSWER (16-BIT) 
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The Assembly Line 



Kraig Brockschmidt 




Welcome once again to the Assembly Line. 
As of October, 1988, feel free to address 
questions to me on Compuserve through my ID, 
76701 ,76. 

ML -DATA Turbo Tranform: 

At one time I needed to put 2028 bytes of 
machine language into Basic DATA statements 
so the ML could be poked in memory by a Basic 
program. Well I wasn't very ambitious to type 
2028 numbers so I made a 111 byte ML program 
that did it for me. I call it ML-DATA Turbo 
Transform, 

The binary program for ML-DATA Turbo 
Transform can be stored in memory using the 
Basic program in Listing 1 ( ML-DATAB . BAS } or 
by assembling the source code in Listing 1A. 
Once the program is in memory, (C)SAVEM 
"ML-DATA" , &H7F9 1 , &H 7FFF , &H7F91 . Listing 2 
ML-DATAO . BAS ) is an operating program for ML- 
DATA which facilitates use of this utility. 
Cassette users— change the LOADM in line 1 to 
CLOADM" "and CSAVE the operating program 
before the ML program on a cassette. The op- 
erating program is described later. 

As in previous articles, a line of BASIC 
code stored in RAM has a rigid structure. 
Transferring machine language to BASIC DATA 
statements requires us to build this struc- 
ture. For a disk system, BASIC programs start 
at address $2600 if 4 graphics pages are 
reserved ( PCLEAR 4). A BASIC program in 
memory appears as follows: 



$2600 
$2601-02 



rAlways 0 

:A 2 byte address pointing to 
the data for the next BASIC 
line . 

$2603-04 :A 2 byte value for the line 
number. 

$2605- :Data for the BASIC line with 
all commands tokenized 
(see Vol 1 #2 of CoCo Clipboard). 

At some point there is a 0 indicating the 
end of the BASIC line. The next byte in mem- 
ory is the start of the next line. The ad- 
dress of this next byte is the address stored 
at $2601-02. From this point on, the 
structure repeats for each line of BASIC 
code, until three zeros occur, signaling the 
end of the program. 

Through the following steps, ML-DATA 
builds BASIC lines. The numbers in par- 



enthasis indicate the lines 
code where the step is done : 



of the assembly 



1 ) Determine where to begin forming 
Basic lines. (110-130) 

2) Get the starting line number and the 
start address for the ML to be trans- 
ferred. (140-160) 

3) Write the line number in the current 
Basic line. (170) 

4) Write a "DATA" and a space the 
current line. (180-190) 

5) Check for the end of the ML being 
transferred" "and exit a loop if it 
has been reached. (210-220) 

6) Otherwise get a byte of ML, convert 
it a two-byte ASCII string (with hex, 
digits), store it in the DATA state- 
ment, and add a comma. (200-480) 

7) If the DATA statement is longer than 
desired, start a new line. To start a 
new line, clear the last byte, store 
next address at the beginning of the 
previous line, and increment the 
line number. (410-520). 

8) Continue loop by returning to step 3 
until step 5 exits loop. (530) 

9) Upon exit, a termination routine pre- 
vents the end of the last line from 
having just a comma or just a line 
number with "DATA". 

It also stores the new end address of the 
Basic program at $1B and returns to Basic. 
(540-660) 

When the , operating program is used, the 
machine language program automatically 
loaded. You are asked to enter the start 
and end addresses of the ML to be transferred 
and the line number you wish the DATA state- 
ments to begin at. These values are stored in 
$14C, $14E, and $150 respectively. Note that 
the start address should always be less than 
the end address and the starting line number 
greater than 6. If the start > end you will 
get no DATA statements. If your line number 
is > 65535 you'll get an ?FC ERROR IN 5. 
Also, if you specify a large beginning line 
number, the line numbers may wrap-around to 
low numbers at the end of the BASIC program. 
Continuity problems can be fixed with a 
RENUM . 

As always, there are several points of 
interest in the ML program. The main routine 
(200-480) loads a byte of ML data to tranfer 
into the A register and copies it to B. If 
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you are familiar with hexadecimal digits 
stored in a byte, you will know that the 
upper 4 bits {the MSN, Most Significant Nib- 
ble) contain the first digit, and that the 
lower 4 bits ( LSN , Least Sig. Nibble) contain 
the second digit. We must isolate and in- 
dividually convert these digits to ASCII. 

Lines 240-290 isolate the first digit in 
the A register by performing a logical AND 
with a bit pattern of 11110000. The last 4 
zeros mask out the second digit. Similarity 
the second digit is isolated in the B reg- 
ister through a logical AND with 00001111. 
The bits of the A register are then shifted 
four bits to the right, so it contains the 
actual value of the digit. For example, the 
conversion of the value $C8 into two digits 
proceeds as follows: 



Line 



A register 



B register 



230 TFR A , B 
240 ANDA #$F0 



11011000=$C8 
U010000 = $CO 



250 
260 
270 
280 
290 



ANDB #$0F 11010000=$C0 



LSRA 
LSRA 
LSRA 
LSRA 



01101000=$68 
00110100=$34 
000U010 = $1A 
00001101=$0C 



11011000=$C8 
11011000=$C8 
00001000=$08 



00001000=$08 



The A register now contains the value of 
the first digit, $C, and the B register con- 
tains the second, $8. Lines 300-390 then 
converts both registers to ASCII. In line 
300, A is compared to 9. If it is greater 
than 9, then it must be a hexadecimal letter 
(A-F) so we branch to LTR. If not, we add 48 
decimal to the value giving it a possible 
range of 48-57 decimal. These are the cor- 
responding ASCII codes for "0"-"9". If we 
branch to LTR we add 55 decimal instead. 
Since it was originally 10-15, the possible 
values for A after the addition are now 
65-70, which translates to "A"-"F" in ASCII. 

This process is perfomed on both A and B 
registers (lines 300-390) and then the 
two-byte ASCII value in the D register (A and 
B together) is written to the current BASIC 
line under construction (400). Lines 410-450 
check the length of the line under con- 
struction, we first save the value of X in D 
and then subtract 77 from X. This number 
(77) corresponds to the length of a BASIC 
DATA statement with 25 elements. We then com- 
pare the subtracter' value to the beginning of 
the line stored at S. If X-77 is less than 
the value at S, a comma is stored after the 
data element and we continue building. If 
not, there are 25 pieces of data in the 
current line so we branch to EOL , starting 
another line. Note that the TFR D,X in- 
struction in line 440 does not effect the CC 
register . 

Lines 490-520 finish up the current line 
and starts the next. It clears the last byte 
of the line, stores the next location at the 
beginning, of the line (see structure), 
stores this value at S, and adds 5 to the 
line number counter (in U). Line 530 jumps 
back to line 200 where we continue building 
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Basic lines. When we reach the end of the ML 
to be transferred the program exits the loop 
to FINUP (540-660). This routine simply fixes 
the end of the Basic line so there are no 
commas or line numbers ending the line. It 
also stores the end address of the new Basic 
program at $1B and returns to Basic. 

By the way, if you're wondering why this 
utility is dubbed 'Turbo Transform', try 
this: enter START=&H8000 and END=&H9FFF in 
the operating program. LISTing the result 
will take a while, but prepare to wait a 
whole 0.93 seconds for ML-DATA Turbo Trans- 
form to construct it!! 
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11 '* ML TO BASIC UTILITY * 

\'Z '* COPYRIGHT (01988 * 

13 l * BY KRA1G BROCKSCHMIDT * 

14 ' * 14 50b NE 3 7 th PI. F-H * 

15 '*beilevue, tvA 98007-3486* 

ZQ CLS:CLEAR20O,&H7F91 :F0RT=1T01 
1 1 ; READAS : X=X+VAL ( " &H " + A$ ) : NEXT : 

R.A.D. PRODUCTS 

presents 
Textform 



I'EXTFORIM Is compatible with all Color Computers 
with a minimum of 64K, disk drive, and printer. This 
machine Language program will format ASCII text 
files into two column pagos quickly and easily. This 
is not another word processor. TEXTFORM is a user 
defineable two column text formatter program which 
will allow your Color Computer to create very 
professional document? without hours of tedious 
work. TEXTFORM i.s a versitiJe enhancement to any 
word processing .system whether you are a casual or 
professional user. 

Ftic-i! For: 

- RnJJftinR - ScIh-oI nr-wnimpers 

- Advert is?*™ t« - Cluli newsletters 

- Program List i n«c^ - Business reports 

- Ami mm- li more? . . 
Rvatum Rpqu i rrninnts : 
CoCo (6-lk minimi™), Disk drive Printer 




Holiday Special — > S29.95! 

R.A.D. Products 
194 Hotchkiss St., Jamestown, NY 14701 
(716) 665-2124 

Terms: Check, C.O.D., Money Order. New York 
residents add 7% sales tax. C.O.D. orders add i3. 
All orders add $3.00 for shipping. 

see qui- coupon on the coupo n page l 



IF XO11010THEN PR I NT'" ERROR IN D 
ATA. " : END 

3 0 RESTORE : FORT =1 'TO 1 1 1 : READAS : PO 
RE&H7F9U+T.VAU "&H"+AS ) :NEXT:PR1 
NT "ML DATA IN MEMORY . " : END 
40 DAT A9E , IB, 30, IE, 34 ,10,FE,01,4 

C , 1 0 , BE , 0 1 , 4E , 30 , 02 , EF , 8 1 , CC , 86 , 
20, ED, 81 ,A6,A0, 10 

50 DAT ABC, 01 ,50, 22, 39, IF, 89, 84, F 
0,C4, OF, 44, 44 ,44,4 4,81 ,09,22,03, 
8B, 30, 8C, 8B, 37 ,C1 

60 DATA09 ,22,03, CB , 30 , 8C , CB , 3 7 , E 

D, 81, IF, 10, 30, 88, B3, AC , E4 , 1 F , 0 1 , 
22 , 06 , 86 , 2C , A 7 , 80 

70 DATA 20 , C9 , 6F t 80 , AF , F4 , AF , E4 . 3 
3 , 4 5 , 20 , B6 , 6F, IF, 30, 1D.AC.E4 , 2 7 , 
02,30,03,C6,06,6F 

80 DATA 85,5A,2A,FB,AF,F1,30,02, 
9F, IB, 39 

*ML TO BASIC UTILITY * 
* COPYRIGHT (C) 1.988 * 
*BY ERA 10 BROCESCHMIDT* 
*14 50G NE J7TH PL N.E.* 
* KENTON, WA 980 56-7 313* 
*********************** 

1 PC LEAR 1 : CLEAR200 , &H7F91 : LOADM" 
ML- DATA " 



2 CLS: INPUT" STARTING POINT (IN H 
EX ) " ; A$ :A = VAL( ,, *H ,, +A$ ) 

3 I NPUT " END I NG PO I NT (IN H EX ) " ; B 
S:B=VAL< ,! &H"+B$ > + l 

4 0=INT( A/256 ) : W=INT( B/256 ) :X = &H 
.1 4 E : POKEX , Q : POKEX+ 1 , A-256*Q : POKE 
X+2 , W : POKEX +3 ,B-256*W 

5 INPUT " STARTING LINE NUMBER" ; S : 
E=INT( S/256 ) :POKE&H14C,E:POKE&Hl 
4D,S-2 5 6*E 

6 EXEC&H7F9 1 : END 

7 'NOTE!! WHEN YOU HAVE PUT ALL 
THE ML INTO DATA STATEMENTS, DEL 
ETE LINES 0-8 OF THIS PROGRAM AN 
D WRITE A PROGRAM TO POKE THE 

8 ' ML INTO MEMORY WHERE YOU WANT 
LIKE IS SHOWN IN LISTING IB. 




M 

IE!!' 

m 



I s gs s§ thin -.:- a ??-. a :- 8 - IS 



25 



isllislisislii! Illlili! "A lilsli iMimm timfchlkz Meeb 

BSS. .5. a . S.I S.I 



liiiiiiiiieiiiiiiieiiiiiiiiiiieiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii 



15 



Using 0S9 Files 



Bob van der Poel 



As I've been telling you all for some time 
now, OS-9 is a super operating system for the 
Color Computer. But something we all tend to 
forget from time to time is that OS-9 is a 
DISK operating system. Not only does this 
mean that OS-9 can load and save programs or 
data to/from disks, it also means that the 
system itself thrives on all kinds of disk 
operations. But before we get to this month's 
article which shows one way we can make 
BASIC09 do some mundane work for us, let's 
review 0S-9's file structure. 

OS-9, unlike some other operating systems 
you may be aware of, has only one type of 
file. There is no inherent difference between 
the structure of a file containing a list of 
names and addresses or the file containing 
the program which reads it. OS-9 cannot tell 
whether a file contains data or executable 
code -- that is job of file attributes. Note 
that attributes are not a part of the file, 
they are part of the file descriptor. 

The file descriptor is a one sector block 
of data which contains -- among other things 
— the attributes of the file, the date the 
file was created and last modified, and 
information on where the file is located on 
the disk. Whenever OS-9 accesses a file this 
information is read. Depending on who you are 
and what you are trying to do OS-9 may or may 
not process your request. On a multi-user 
system you may not be the owner of a file, 
and unless the "public read" attribute is set 
OS-9 will not let you read the file. Sim- 
ilarly, if the "write" attributes are not set 
no one can write or delete the file. If a 
file is an executable program then it will 
have the "execute" attributes set. Again, 
there are separate "execute" flags for the 
owner of a file and other users on the system 
(public). Most of the file attributes can be 
changed with the OS-9 ATTR utility, however 
you cannot change the attributes of a file 
you do not own. 

File attributes cause lots of problems for 
beginners especially if they have down- 

loaded a program, attempted to create a new 
Shell module by merging several programs 
together, or extracted a program with an ar- 
chiving utility (like AR ) . OS-9 will balk at 
any attempt to load a program which does not 
have its "execute" attribute(s) set. It's 
simple to do -- just use ATTR to set the "E" 
and "PE" attributes. Does this mean that if 
we change the attributes of a data file to 
"E" and "PE" it will be loaded into memory? 
16 



No. OS-9 does other checks to make sure the 
"program" is correct ... but that's grist for 
another article. 

Most of the time when we think about files 
we focus on two kinds: Data files and exe- 
cutable programs. But let's not forget that 
files can be used for more than just data 
storage. Files can also contain instructions 
for programs or OS-9. Procedure files are an 
example which comes to mind right away. 

A "procedure file" is a file which contains 
commands which you would normally type in 
from the keyboard ... but because we're lazy 
(or just against drudgery) we can put these 
instructions in a file. The file "startup" on 
your boot disk is a good example of a pro- 
cedure file. Startup contains instructions 
which OS-9 fulfills each time it is booted. 
The only unique thing about "startup" is its 
name -- OS-9 always checks the root directory 
of the disk it is booting from for a file 
called "startup." If it finds one, the in- 
structions in the file are carried out. If 
"startup" does not exist, no damage is done. 
One caution about invoking programs from 
within procedure files: When interpreting a 
procedure file OS-9 expects input to come 
from the file, not the keyboard. If a program 
needs input from you (the keyboard) then you 
must redirect input when the program is in- 
voked . 

Here's a quick example. You wish to auto- 
mate the process of creating a new system 
disk, so you write the following procedure 
file: 

echo Creating new boot disk, ready /dl 
format /dl 
cobbler /dl 
makdir /dl/CMDS 
chd /dl/cmds 

copy /dO/cmds/grfdrv grfdrv 
copy /dO/cmds/shell shell 

The above procedure will not work. Format 
will print an "are you sure" message and wait 
for you to answer y(es) or n(o). Since input 
is coming from the file the first reply will 
be "c" (the first letter in "cobbler"). For- 
mat will re-prompt and get "o" as a response. 
Eventually it will get to the the "y" in 
"copy" and the disk will be formatted. How- 
ever OS-9 will not like the name "/dO/cmds 
/grfdrv," nor will it be able to execute the 
command "grfdrv." 



The solution? Well actually there are two. 
We could change the format command so that no 
keyboard input is required: 

format /dl r "MyDisk" 

will work fine. However, if we wish to have a 
prompt -- nice, just in case the disk in /dl 
contains valuable data -- then we could use: 

format /dl </l 

Note that instead of "</l" we could have used 
"</term," but that would only work if we were 
using "term" as our active window. If would 
create all kinds of problems if we were using 
*7w2." 

If you create a special "startup" file to 
automatically invoke a favorite program, then 
redirection is also needed. I have a special 
disk which brings up my mailing list program. 
The final line in the startup file reads: 

dml9 <>>>/l 

Here not only input, but also output and 
error output has been redirected. The last 
two should not be necessary, but leaving them 
out sometimes causes problems. Play it safe 
and redirect all three paths. 

There is one more use of files: com- 
municating with other programs. Probably the 
best example of this is the C-Compiler ex- 
ecutive. Creating a C program is a rather 
complex process of creating/editing a text 
(source) file, having various programs con- 
vert the source file to an assembly language 
source file (compiling), calling RMA to 
assemble the complied code, and then calling 
the OS-9 linker to create the final program. 
Rather that forcing you to remember all this 
the C-compiler comes with a program which 
creates a procedure file with all the nec- 
essary instructions to convert your source 
file to a loadable program. 

I write a fair number of letters. I use an 
editor to create the text of the letter, save 
the text to a disk file, then I use one of 
the many text formatters available for OS-9 
to format the text and print it out. Simple, 
but a bit tedious. First off, there's that 
matter of my "letterhead" information. I keep 
a file called "header" which is included in 
each letter. It contains my name, address, 
etc. and some formatting information. How- 
ever, it must still be loaded (or included) 
for each letter I write. But a greater ir- 
ritant is the fact the the formatter will 
only print one copy of the letter. If I want 
two copies I have to call the formatter 
twice. And if I want the second copy to be in 
correspondence quality rather than draft then 
I have to remember to set the printer. Too 
many things for me to remember. But aren't 
computers supposed to be good at doing 
tedious things? 

The program listing "lp" takes the tedium 
out of printing letters. It's a simple pro- 



gram which I hope you will change and expand 
for your own needs. 

Lp creates a file which contains the 
following : 

1. Some initial format information for my 
text formatter, 

2. The letterhead information with my name, 
etc . , 

3. A line to print out todays date, 

4. An "include" instruction to print the 
actual letter, 

5. A closing to the letter, 

6. A "start new page" command, 

7 . A format code to turn on correspondence 

mode , 

8. A duplication of items 1 to 6. 

After the file is created the program calls 
the formatter and two copies of my letter are 
printed. Finally, the temporary file is 
deleted -- all this simply by typing the 
command : 

lp ("Jim") 

Note the parentheses and quotes around the 
argument. These are needed for a packed BASIC 
09 program, unless you are using an enhanced 
shell program such as Shell+. 

There is nothing very complicated about lp, 
however I do wish to point out a few high- 




roke 'r Broker 

by Roy C. Pierce (c) 1986 

Buy & Sell your way to Power in this Exciting Stock Market Simulation. 
2 - 6 Players Ages 10 & Up. 

tbt since Stock Ticker® havs I had so much Funf F.G. Dawson 
■Easy to Learn, Fun to Ptayr A_R Fazacterfey 

1 28 K CoCo Required, Disk or Cassette. $23. 95 



Challengliig Two Player Games by Roy C . Pierce (c) 1988 

ADI OTHELLO CONNECT 5 

FAST AN) FUN FOR AIL AGES 

EASY TO RUN . m 

ALL BASIC OOMtETHY USTABLE $19.95 




Disk Directory Utility 

(See September & October Rainbow) 
"...One Probssbna! Looking, WeH B9haved.and User Friendy Utfty for BASIC Pmgnamsr 
Tto your Fingm a Favor arid htoo\ce C<& 

Review $19 95 

Prices Shown are in U.S. Funds. *P±v.cr<J 
Include Cheque or Money Order when Ordering. 
On Orders of 2 or more Programs Deduct 10% from Total Price. 
We Pay the Freight 
In Canada Please Phone for Prices. 
ALL Foreign Orders Add $5.00 

**** No c ° D P.OBOX 1787, 
Kl , MTTTTJm? Main Post QfDce. 

irjrtVvil/ Edmonton, AB. Canada 

SOFTWARE m: (403) 47^43! 
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lights. The routine which builds the string 
"today" assumes that the system date has been 
properly set. The month name is determined by 
reading through the data statements for the 
value of the month number from DATE$ . We ex- 
tract the month number with the MID$ func- 
tion. The IF/ELSE is needed to strip off a 
leading "0" from dates like "January 03." 

Before attempting to create the temporary 
file, we first attempt to delete that same 
file. In most cases this will not be nec- 
essary, however if we attempt to create a 
file which already exists we'd have to delete 
it anyway. Note that error trapping is only 
active for the DELETE. Any other errors will 
simply end lp. 

The subroutine at line 100 reads the data 
statements at 1000 and sends them to the 
temporary file. Have a good look at the data 
statements -- not only do they contain string 
constants, they also contain variables and 
expressions. BASIC09 is the only language I 
know of which permits expressions in data 
statements -- a very useful feature. 

As it stands, lp is a very specific program 
something I don't like to publish. 
However, it should be easy enough to modify 
to include your letterhead and codes for your 
text formatter. Feel free to play with the 
code -- that's how you learn. 

Finally, this months challenge: Can you add 
or devise a "better" method for creating the 



temporary file name? Can you find another use 
for a program like lp? Let me know, maybe 
you'll even get your name mentioned here! You 
can write to me at: 

17435-57 Avenue 
Edmonton, Alberta 
Canada T6M 1E1 



Jo in_Jed. P au 1 & Dan Robins 
for our monthly Clipboard con- 
ferences on CompuServe I Please 
note: we've moved the Confer- 
ences to FRIDAY NIGHTS! The time 
is the same 9pm Eastern. 

The November guest will be 
Tony DeStafeno from Disto. Our 
December guest will be Bill 
Vergona from Cer-Comp and Jan- 
uary will tentativley feature 
Dr. Lester Hands - author of 
Lyra . 
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CocoTech 




You can use UltiMax as a normal IU-REZ 
joystick niterfacG or switch it to be 
used with a popular Max III graphics 
program. The other feature of UltiMax 
is the option to have a large or small 
stick area so you can be more accurate 
with your drawings! 

The UltiMax interface is only 529.95 

Or trade in your original fliRes inter- 
face ( sent postage prepaid ) and get 
UltiMax for only $14.95 



With MACPL.AY and a CoCo 3 you can play MAC sound 
files (Included on the second diskette) with pure 
6 BIT sound quality that the CoCo can produce! Or 
download other MAC sound files from a computer 
information service or MAC bulletin board systems 
to hear even more. Sound files can last for a few 
seconds or up to 1/2 minute. MAC sound files 
included on the seconds diskette contain excerpts 
from the 3 Stooges to the Road Runnner and more I I 

MACPLAY is only $ 19. 95 



PA residents 
add 6% sales 



Send to: 
CocoTech 
208 Cathy Ann Drive 
Reading, PA 19606 
(215)-779-?768 



Shipping and handling: 
USA and Canada add $2.50 
Other countries add $5.00 

** We now handle 



Please allow 
1 to 3 weeks 
for delivery 

Sorry no 
credit cards 
YET J 
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Clip'Ettes 



Jim DeStafeno 




- LINE LINEUP: 

This one is from Rush Caiey as a result of 
my complaint. He laughed when he found I 
didn't know. Was I the only one in the dark? 
As anyone knows that uses a CoCo word pro- 
cessor, the printer code uses a character 
space on the screen, but since the printer 
doesn't print them, the printed line is one 
character shorter then the screen line. 

A printed line with 4 or more printer 
codes looks bad enough; pretty short. How- 
ever, if you make a form with vertical lines, 
bold print, underlining, etc., lining up 
columns can be come a nightmare. 

Try this, it works perfectly. The base of 
the idea is founded on the fact that most 
every printer code is, or can be, preceded or 
followed by a space. So, just set a space in 
the printer code itself and don't use one in 
the text. Then when the printer encounters a 
printer code, it will not print the code, and 
thereby lose a character space in the printed 
line, but it will print a space. The result 
is a net gain/loss of zero line character- 
spaces between the displayed line and the 
printed line, and therefore everything lines 
up on the screen and on the printed page. 

The drill goes this way. When you set up 
the printer code, put in a 32 either in front 
of or behind the code, (That is the ASCII 
value of a space.) Example, 32 nn nn nn or 
nn nn nn 32. (The ns represent the printer 
code.) When you type in a line, think of the 
printer code as a space; do NOT type in a 
space . 

- FUNCTION, CTRL and ALT KEYS SENSING FROM 
BASIC: 

The program below demonstrates how to 
sense the function keys from BASIC, It's not 
a bad input engine for fields or a word pro- 
cessor. (Note, if you do use it, be sure to 
filter out the Left Arrow and Clear keys; 
similar to what is done in line 20 for ENTER. 
You'll fine the program to be fast enough, 
but the Hi-Speed Poke wouldn't hurt. However, 
a fist full of IF statements will slow it 
down. It will work fine if a second INSTR 
statement is used to do the filtering.} 

Anyway, check out how this thing works. 
There is a keyboard table in memory locations 
338 through 345. If the memory location has a 
number in it other than 255, a key is being 
pressed. A given number in a given location 
tells the computer which key is being 
pressed. The location for <F1> is 343; <F2> 
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is 34 4, CTRL is 3 42 and ALT is 341. The 
For/Next lets us Peek into these locations 
and check out the values. 

5 CLS:C$=CHR${ 255) : C=191 : D$=CHR$( 103 ) +CH 
R$< 52 )+CHR$(4 )+CHR$( 214 )+CHR${ 189)+CHR$( 
1 )+CHR$(64) :PRINT@32 ,C$ ; 

10 EXEC44539:I$=INKEY$:FOR X=341 TO 344: 
IF PEEK(X)=C THEN ON INSTR(D$,I$) GOT031 
,32,33,34,35,36,37 ELSE NEXT 
20 IF I$=CHR$(13) THEN A$ = " " : CLS : GOT05 E 
LSE A$=A$+I$ :PRINT@32 ,A*C$ :GOT010 

31 PRINT@4 5 2 , "<F1 > KEY ACTION" : GOTO 1 0 

32 PRINT@452 , "<SHIFT Fl> KEY ACTION " : GOT 
010 

33 PRINT@452, "<F2> KEY ACTION" : GOTO10 

34 PRINT@4 52 , "<SHIFT F2> KEY ACTION": GOT 
01 0 

35 PRINT@452 , "<CTRL> KEY ACTION" : GOTO 10 

36 PRINTS452, "<SHIFT CTRL> KEY ACTION" :G 
OTO10 

37 PRINT@452 , "<ALT> KEY ACTION" : GOTO10 

It is handy each of key's "is being 
pressed" code is 191. So if we Peek the four 
locations and find a 191 , we know which key i 
is being pressed. However, the shift key has 
no effect on the numbers in keyboard table. I 
(Expect there is another memory location to 
sense that, but I don't know where it... 
Help? ) 

So once the program has determined if one j 
of the four keys has been pressed, INSTR is 
used to determine which one. Notice line 5 
sets D$ to the ASCII code, CHR$(n), of seven 
characters, our four keys; shifted and un- 
shifted. (The shifted ALT doesn't affect the 
key table . ) 

One question might come to mind, "Why not 
just use the ASCII code to sense which key is 
being pressed without using the For/Next?" 
ell, Fl has the same ASCII code as the 
owercase "g" , one of the others is the same 
s "4" and CTRL-ALT is the same as "@" ; but 
one of them have the same same "key table 
ode" as their counterpart. 

Of course if you want to get fancy, there 
re lots of ways to modify the program to 
hange the quantity and/or order of the sen- 
ors to get different results. 

YOU and CLIPETTES: 

If you have some favorite programming 
ricks, send them in to the magazine or my- 
self; RD1 Box 275, Wyoming, DE 19934. 



GOT THOSE 

You're not alone. Many Color Computer users have experienced the frustration of buying a cheap imitation of 
our Hard Drive Basic and then discovering that their favorite programs no longer workl 

Mow, you can FIX those compatibility problems, ELIMINATE the bugs, SPEED up your system and PREPARE for 
tomorrow's disk drives . . . buy your DOS from the company that invented the original Hard Drive Basic years 
ago! 

Supercharge your Color Computer with RGB-DOS! 

Why RGB-DOS? Because RGB-DOS is the first and only Disk Operating System to bring STANDARD Small Computer 
Systems Interface (SCSI) device drivers to the Color Computer system, running under Basic. 

What does this mean to you? 

First, SCSI is an accepted, industry standard interface system. This allows you to run one or more Hard Disks 
of any size on your Color Computer in Basic or under OS-9. But wait! There's MORE! 

Because it provides generic SCSI drivers, RGB-DOS will ALSO run devices which you may not have TODAY, but 
will need to run TOMORROW, such as Streaming Tape Backups for the Hard Disk, CD ROMS and of course, 
Optical (Laser) Disk Drives! 

RGB-DOS, combined with the KEPI-TON or DISTO SCSI Interface, will assure you that your Color Computer System 
will be compatible with the ever growing line of mass storage products available both TODAY AND TOMORROW. 

Mere are some of the many features of RGB-DOS: 

•Hundreds of systems in daily use - PROVEN QUALITY 
•Runs ALL popular COCO software - FULLY COMPATIBLE 
•Will AUTO-BOOT ANY program from Hard Disk or Floppy Disk 
•Full Screen Directory Display for COCO 1, 2 and 3 
•Automatic Drive number. Free Space & Disk name Display 
•Supports Double Sided Floppy Disk Drives 

• Reliable Floppy Disk Operation with the "High Speed Poke" 

• Improved "COPY" command - Copy Filename to Drive Number 

• "RUNM" Command for Machine Language Programs 
•FLEXIKEY - Command Recall & Edit System by Colin J. Stearman 
•Fixes the COPY bug, the DSKTNI bug, the DOS bug & many others 
•Will run two Hard Disk Drives of the same or different sizes 

•Will run Streaming Tape Backup systems & Laser Disks 
•Automatic Hard Disk Size detection. NO drivers to configure 
•Works with the LR-TECH, DISTO 6f KEN-TON Hard Disk Interfaces 
•NO extra RAM used or extra tokens added. FULLY COMPATIBLE 
with The Color Computer 1, 2 OR 3 WITHOUT MODIFICATION 

•Easily Affordable. The RGB-DOS System Disk with Users Manual 
is only $29.95 plus $3.00 shipping & handling 

Don't ivait! Supercharge your Color Computer TODAY . . . with RGB-DOS! 
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Fully Compatible with R.S. Dos 
Enhanced Basic, it does not need 
or use OS-Si and you don 5 1 have to 
be a Rocket Scientist or a P.H,D. 
to use Windows* Pull Down Menus, 
Buttons > Icons, Edit fields or 
House Functions in your Programs* 
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Screen Display Fonts 



Window Master supports up to 54 different character sizes on 
the screen with 5 different character styles. You can have Bold, 
Italic, Undented, Super-Script, Sub-script or Plain character 
styles or any combination of them in any character size. You 
can also change the text color and background at any time to get 
really colorful displays. 

Fully Basic Compatible 

Window Master is fully compatible with Enhanced Color 
Disk basic with over 50 Commands & functions added to fully 
support the Point & Click Window System. Window Master 
does not take any memory away from Basic, so you still have all 
the Basic Program memory available. 

Hi-Resolution Displays 

Window Master uses the full potential of the Color 
Computer 3 display by using the 225 vertical resolution display 
modes instead of the 192 or 200 resolution modes like most 
other programs. It uses either the 320/16 color mode or the 
640/4 color display to give you the best display resolution 
possible, and can be switched to either mode at any time. 



Window Master Features 

Multiple Windows 

Window Master supports multiple window displays with up to 
a maximum of 31 windows on the screen. Overlapping windows 
are supported, and any window can be made active or brought to 
the top of the screen. Windows can be picked up and moved 
anywhere on the screen with the mouse. There are 6 different 
Window styles to choose from and the window text, border and 
background color is selectable. 

Pull Down Menus 

Menus are completely programmable with up to 16 menus 
available. They can be added or deleted at any time in a 
program. Menu items can be enabled, disabled, checked or 
cleared easily under program control. Menu selection is 
automatically handled by Window Master & all you have to do 
is read a function variable to find out which menu was selected. 

Buttons, Icons & Edit Fields 

Each Window can have up to 128 buttons, Icons or Edit fields 
active, if you can fit that many. Buttons, Icons and Edit field 
selection is handled automatically by Window Master when the 
mouse is clicked on one. All you have to do is read a Dialog 
function to find out which Button, Icon, or Edit field was 
selected, its very simple. 

Mouse & Keyboard Functions 

Window Master automatically handles the Mouse pointer 
movement, display and button clicks. It will tell you the current 
screen coordinate, the local window coordinate, window number 
the mouse is in, the number of times the button was pressed, 
which window number it was clicked in and more. The 
Keyboard is completely buffered, and supports up to 80 
programmable Function keys that can contain any kind of 
information or command sequences you can imagine. You can 
load and save function key sets at any time. So, you can have 
special sets of function keys for different tasks. The "Ctrl" key is 
supported so that you have a full control code keyboard 
available. 
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Mixed Text & Graphics 



Window Master fully supports both Text & Graphics displays 
and even has a Graphics Pen that can be used with HLINE, 
HCIRCLE, HSET and more. You can change the Pen width & 
depth and turn it on or off with simple commands. We also 
added Enhanced Graphics Attributes that allow graphics 
statements to use And, Or, Xor and Copy modes to display 
graphic information. With the Graphics enhancements added 
by Window Master, you could write a "COCOMAX" type 
program in Basic! In fact we provide a small graphics demo 
program written in Basic. 



Event Processing 



Window Master adds a powerful new programming feature to 
Basic that enables you to do "Real Time" Programming in Basic. 
It's called Event Trapping, and it allows a program to detect and 
respond to certain "events" as they occur. You can trap Dialog 
activity, Time passage, Menu Selections, Keyboard activity and 
Mouse Activity with simple On Gosub statements, and when the 
specified event occurs, program control is automatically routed 
to the event handling routine, just like a Basic Gosub. After 
servicing the event, the sub-routine executes a Return statement 
and the program resumes execution at the statement where the 
event occured. 

Enhanced Editing Features 

Window Master adds an enhanced editor to Basic that allows 
you to sec what you edit. It allows you to insert & delete by 
character or word, move left or right a word or character at a 
time, move to begin or end of line, toggle automatic insert 
on/off or just type over to replace characters. The editor can 
also recall the last line entered or edited with a single key stroke. 
You can even change the line number in line to copy it to a new 
location in the program. 



Window Master Applications 



Window Master pushs the Color Computer 3 far beyond its 
normal capabilities, into the world of a "User Friendly" 
operating enviomment. We are already planning several new 
programs for use with Window Master. So you don't have to 
worry about having to write all your own programs. And don't 
forget that many existing Basic and M.L. programs will run 
under Window Master with little or no changes. The 
Possibilities for Application programs are endless: Spread 
Sheets, Word Processing, Communications, Education, Games, 
Graphic Design, Desk Top Publishing and on and on. 

Hardware Requirements 

Window Master requires 512K of memory, at least 1 Disk 
Drive, a Hi-Res Joystick Interface and a Mouse or Joystick. 

Technical Assistance 

If you run into difficulty trying to use some of Window 
Master's features, we will be happy to assist you in any way 
possible. You can write to us at the address below or call us 
between 10am and 2pm Pacific Standard Time for a more timely 
response. Sorry, no collect calls will be accepted. 

Ordering Information 

To order WINDOW MASTER by mail, send check or money 

order for S69.95, plus 53.00 for shipping & handling to the 
address below. To order by VISA, MASTERCARD or COD 
call us at (702)-452^632 
(Monday thru Saturday, 8am to 5pm PST) 

CER-COMP Ltd. 

5566 Ricochet Avenue 
Las Vegas, Nevada 89110 
(702V452-0632 
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The Chicago Rainbow Fest opens today, 
and we will be there with Uindow Master! 



CoCo 'N Amateur Radio 



Mike Dooley KE4PC 



Editor's Note: In our last iss 
part of the Basic program li 
supplied to us. To our fai 
Amateur Radio column readers 
apology . We are running the ent 
this issue. Mike's regular 
this listing. 

RTTY . BAS 

5 REM THIS PROGRAM IS PUBLIC DOM 

AIN , BY N6LQV 

10 CLEAR 200 ,&H4000 :C = 3 

20 D=(PEEKUHC000) = 68) : REM TAPE: 

D=0, DISK: D=-l 
30 IF D THEN LOADM " RTTY " ELSE CL 
OA DM "RTTY" 

40 DEFUSR0=4HE00 : DEFUSR1 =&HE03 
50 DEFUSR2=&HE06 : DEFUSR3 =&H£09 
60 DEFUSR4=&HE0C:DEFUSR5=&HE0F 
100 A=USR0( 0 ) :R=0:T=0 
110 CLS: AUDIO ON : MOTOR OFF 
120 PRINT" **** RTTY TERMINAL PRO 
GRAM ****" 
130 PRINT" 
BYTES" 

140 PRINT" SAVE RECEIVE BUFFER 
" ;R 

150 PRINT" PRINT ' ' 

160 PRINT" SHOW 

170 PRINT" RECEIVE /TRANSMIT" 

180 PRINT" LOAD TRANSMIT BUFFER 

II . rp 

190 PRINT" CLEAR ALL BUFFERS " 

200 PRINT" BAUD RATE: " ; 

210 ON B+l GOTO 220,2 30,240,250 

2 20 PRINT" 4 5 WPM : 6 0": GOTO 260 
230 PRINT"50 WPM: 67":GOTO 260 
240 PRINT"57 WPM: 75":GOTO 260 
250 PRINT"74 WPM: 100":GOTO 260 
260 PRINT 

270 PRINT" DURING RECEI VE/TRANSMI 
T : 11 

280 PRINT" BREAK: RETURN TO THIS 
MENU" 

290 PRINT" CLEAR: TOGGLE RECEIVE 
/TRANSMIT" 

300 PRINT" RIGHT ARROW: TRANSMIT 
BUFFER" ; 

310 A=C*32:PRINT«A+32, " ";:PRIN 
TSA+64 , "->" ; : PRINTSA+96 , " " j 
350 FOR 1 = 0 TO 3():NEXT 
360 A$=1NKEY$ 

3 70 IF C>0 AND (PEEK (341) AND 8) 
=0 THEN C=C-l:GOTO 310 

380 IF C<6 AND (PEEK(342) AND 8) 
=0 THEN C=C+l:GOT0 310 
3 90 IF A$OCHR$(13) THEN 3 60 
400 ON C+l GOTO 800,500,550,600, 
700, 100,950 

500 IF (PEEK( &HFP22 )AND1 ) THEN 1 
10 

24 



ue we left out 
sting Mike had 
thful CoCo 'A' 
we offer our 
ire listing in 
column follows 



510 A=USR5 ( -2 ) : PRINT" ":GOTO 1 
10 

550 CLS:A^USR5( 0 ) 

560 IF I NKEY$ = " " THEN 560 ELSE 1 
10 

600 CLS : PRINT" RTTY RECEIVE M 
ARK — > < - -SPACE" :R=USR1 (B) : GOTO 1 
10 

700 S$ = "LOAD FILE" ;GOSU13 900 

710 IF A$="" AND D THEN 110 

720 CLS: PRINT@229 , "LOADING ";A$ 

730 IF D THEN F=l ELSE F=~l 

7 10 OPEN"T" , F , A $ : A = USR2( 0 I 

750 IF EOF ( F ) THEN 790 

760 LINEINPUT #F,A$ 

770 A$=A$+CHR$( 13) :A=USR3(A$ ) 

780 IF A THEN 750 

790 CLOSE F:T=USR4(0) :R=0;GOTO 1 
10 

800 IF R=0 THEN 110 

810 S$="SAVE FILE":GOSUB 900: IF 

A$ = "" THEN 110 

830 CLS : PRINT@229 , "SAVING ";A$ 
840 IF D THEN F=l ELSE F=-l:GOTO 
870 

850 PRINT@293 , "ARE YOU SURE (Y/N 

) " ; : INPUT S$ " 

860 IF S$<>"Y" THEN 110 

870 PRINT@293,"" :OPEN"0" ,F,A$ 

880 A=USR5(F):CLOSE F:GOTO 110 

900 CLS: PRINTS$ : PRINT 

910 LINEINPUT" FILENAME? " ; A$ 

9 20 RETURN 

950 B=B+1:IF B>3 THEN B=0 
960 PRINTG269, " " ; : GOTO 210 

MAKERTTY . BAS 

10 REM TiilS PROGRAM IS PUBLIC DO 
MAIN, BY N6LQV 

20 PCLEAR4 
30 CLS 

40 PRINT" RADIO TELETYPE TRANS 
CEIVER" 

50 PRINTSTR1NG$( 32 , "-" ) ; 
60 PRINT 

70 PRINT"NOW GENERATING MACHINE 

LANGUAGE" 

80 PRINT 

90 PRINT" PLEASE WAIT,.," 
100 ST=&HE00:AD=ST:L1=900 
110 READA$ , CS 



120 IF A$^"X" THEN 2 00 
130 FOR 1=1 TO 64 STEP 2 
140 A=VAL( "&H"+MID$( A$ ,1,2)) 
150 POKE AD,A:CS=CS-A:AD=AD+1 
160 NEXT 

170 IF CS THEN PRINT" DATA ERROR 

IN LINE" ; LI : END 

180 PR I NT® 1 7 4 , 94 9- LI 

} 90 LI=LI+1 :GOTO 110 

200 IF PEEK ( &HC000 ) ~ 68 AND PEEK ( 

4HC001)=75 THEN B$="DISK" ELSE B 

$="TAPE" 

210 PHI NTS96 , "PROGRAM IS NOW IN 
MEMORY AND" 

220 PRINT" READY TO BE SAVED. INS 
ERT ";B$ 

230 LINE! NPUT" AND PRESS ENTER "; 
A$ 

24 0 IF B$-"DISK" THEN 2 80 

2 50 CSAVEM" RTTY" , ST , AD-1 , CS 

260 LINEINPUT" PRESS ENTER TO SAV 

E AGAIN " ; A$ 

270 GOTO 250 

2 80 SAVEM " RTTY . BIN" , ST , AD- 1 , CS 
290 END 

900 DATA16003216U1 1 5 1 60068 1 6006C 
1 6003 2BDB3EDD7 6FBE4 01 3BC4 01 524 18 
A680AD9F , 2607 

901 DATAA00 2 966F26F1AD9FA000 2 7EB 
AD9PA000 2 7FA20E3 3 98D2D8E7FFF9F1 7 
8E40299F, 3863 

902 DATA048D219E04BF1202BF12O89F 
069F08308904009C1723029E1 79F1 39F 
15DC0483 , 2591 

90 3 DATA4 0 29 2O4E3 4 04C6 40200 334 04 
5F1F9B3 584 8E4 02 9BF4 004 3 98DEAEG84 
EE0 2 9E04 ,2792 

904 DATA3O89O40O9C1 7242F1 08E0EBB 
A6CO3 4O4 84 7FC6FE810D2 7OC8O2O2 5OE 
813F2502 , 25 7 0 

90 5 DATA80 2 0E6A61 F985D1 703C63 504 
5 A 2 6 D D C C F F F F 8 D B 6 7 E B 4 F 4 4 F 5 F 2 0 F 7 F F 
2D31 3429, 3944 

906 DATA803A2B2F3280802C233C3D36 
373321 2A 30352726382 E3E8 080 803980 
43594E49, 2235 

90 7 DATA 4 14D5A54464B4F525C4C585 6 
574A4550475E535D555 1 80808O258O0F 
6215D805 , 2085 

908 DATA21O2900DFC13DB04A90255OC 
441 16B041 70 20B0 9 7 30D6A0 32 601 93BD 
B3ED8608 ,2365 

909 DATA3D8E0EFB3AEC84 FD1 131 ECO 2 
FD115 8EC04FD104 3FD1064EC06FD10 92 
7FFF4017 , 3880 

910 DATAFF2 28E03004F6F804A26FB0F 
0 2CCFEF8DDO00F0A0F0B8E1 3 7 39F0E9F 
260F220F.2820 



911 DATA230F1D8E0420CC6060ED818C 
06002 5F98E05E09F0C86BFA784 8E05A0 
9F24869F, 3412 

912 DATAA7841 A50 17008 71)6 23 2 6048 D 
162 0F51CAF17FED6AD9FA0002 6FAFC40 
15B34013.3367 

913 DATA16FF0F9E26A6862B3AJF8981 
602 5O2CO4 08D5 0816026028D4 4 9E24A7 
808C05O0, 3098 

914 DATA251A8E04 20EC8820ED818C05 
A0 25F6CC6060ED818C0 5C0 2 5F98E05A0 
9F24869F, 3779 

915 DATAA784 3 94C260CC60D8D1 98660 
A79F402420D04C26058E1 39320064C26 
058E1373.2615 

916 DATA9F26399E159CJ 724 0 1 E7809F 
1 5 3996222703 1700F4 96232701 390FJ E 
OF] F0F1 B , 2 1 5 6 

917 DATAC613 8D78DC1A815 2 250 721FE 
5A2A0A20DD5C2B02 200 3OC00 7FD7 1 B4 F 
D61AD31E, 2966 

918 DATADD1E8300002406AC01AC0120 
O3DD1E8 60597 20CC0013971B9 71C8D4 0 
4FD61AD3.2901 

919 DATA1EDD1E830000240FDC1A81 52 
C900D71B0C1C12C61220E3DD1ED61B58 
Dl 1C0621 ,2752 

920 DATAOA2026CFAC94C6088D124FD6 
1AD31EDD1E83000025EE962 144 4444 39 
8D1C4FD3 , 31 40 

921 DATA1 EDD1ECC00028D42CB028D3A 
CB028D3 6D71AC05 95 02B02 200 3CCOOOO 
C10F2202 ,2628 

922 DATA2003CC000FD1 1D26063D3DAC 
8B2013 8EO410A08584BFA7 8 59 61DD71D 
E686CA40.3157 

923 DATA E 786 1 701 2639AC01 AGO 18601 
5CC1602504A1012005B5FF2027F25CC1 
602504A1 , 2918 

924 DATA012005B5FF2026F2398EO4O5 
CE14 2BA6C0A7808C04 0D2 5F7CC34 3CF7 
FF21B7FF, 3646 

92 5 DATA018602B7FF200F1E0F1F9EO6 
9C04 2 7 24CC0000DD11 8 605 97 2 0E6809F 
06D7215F, 2727 

926 DATA8D54AC91CC0008 5A26FD04 21 
8D4 80A20 2 6F2EC9B3DAC8BCC0000DD11 
538D3796 , 3344 

92 7 DATA 2226C7CC3 4 3CB7FF2 1 F7FF0 1 
8E04 0 5CE14 2 3A6C0A7808C04 0D2 5F7 39 
B6FF208A, 3731 

928 DATA02B7FF2O862A971O39B6FF20 
84FDB7FF20862 79710392404 8DE22004 
8DEB2000 , 3444 

929 DATA80 1 D4A26FDB6 FF2088FCB7FF 
20D6104FD31EDD1E931124088D0F9610 
802320E2 , 3601 

930 DATADD1E3 9AC94 3DAG01399602 2 6 
7CDC00C03 7 4 98A0124 02 200 3CCFEF8DD 
008E0300.3057 

931 DATA3AB7FF02B6FF008A801F8 9E8 
84E484 21FEA784 860 7DD029E04 9C062 6 
C69C0826.3805 

932 DATAC48E00009F069F089F04 3 996 
02 2 63ADC0OC03 74 98A0124 0220O3CCFE 
F8DD008E, 2959 

933 DATA03003AB7FF02B6FF008A801F 
89E884E4 84 26BEA784 96014C2 7088B3 7 
970121FE, 3530 . 

9 34 DATA2 0818 60 7DD0216FF7A4A9702 
D601CBO8D70104 03 2 4 7D867FB7FF02B6 
FF008440, 3295 

935 DATA27058E13B320058E13EB2000 
A685E68 52B289E04 980AD70A84 602 609 
C41FE780 , 3004 



93 6 DATA3D21FE2012C54 02 6048 61B20 
048 61 F2000C41FED81A1019F04 399E04 
5C260E96, 2526 

937 DATAOA8440970ACC0004E7803D20 
EA5C260BCC0802A780ED81A18B20DC5C 
2649D622, 3280 

938 DATA2 70D8E402 99F068E0000 9F04 
9FO8393DAC8B39D60B2 74 7O004D70B8E 
05E03AEC.2844 

93 9 DATA84ED88E0CC6060ED8 1 EC84ED 
88E0CC6060ED84D60B2 704 3DAC84398E 
05E09F0C.4453 

940 DATA86BFA784 21FE3 9 5C26060322 
AC84 3D395C2 60 70F2203 2 3AC84 3 93DAC 
01399E08,2605 

941 DATA9C04 2607CC000C5A26FD39A6 
809FO8 9E0EA686 2B12 9E0CA7808C06O0 
241 39FOC, 2690 

942 DATA86BFA784AC8B3 94C2 60F1286 
60A79F4 0OC8620 9 70B3D3 084 394C26O9 
8E1 3939F, 2987 



943 DATA0EA101200B4C26O78E1 3739F 
0E200 1 3D3D1 239804 5FF I 160534 95580 
44524A4E, 2303 

944 DATA464 34B54 5A4C57485950514F 
4 24 7FE4D585 6FD807 3FF6D605E78 7 780 
64746760,3436 

945 DATA617A68756269726376707179 
7F66FE6E6F7BFD804 3 5 94E4 9414D5A54 
464B4F52, 3457 

94 6 DATA5C4C58565 74A4 5 504 75E53 5D 
5551258080FDFF363733212A30352726 
382E3E2C.2581 

947 DATA233C3DFEFCFB808080808080 

4 3 594E4 9414D5A54 4 64B4F5 2 5C4C585 6 
574A4550, 3262 

948 DATA475E535D5551258080FDFF80 
2D3134 2 980 3A2B2F3280808080803 9FE 
FCFB8080 , 3659 

949 DATA808080524543454956456054 

5 241 4E534D4 954000000000000000000 
00000000 ,1621 

950 DATAX , &HE00 



Hmmmmm. . . . CoCo's and Amateur Radio. 
What else can we do with this combination? 
How about antennas? Every Amateur needs a 
good antenna to operate a radio. Radios just 
don't work very well without them! 

A good, simple, antenna is the dipole. 
Figure 1 shows what the dipole will look 
like. There are insulators at each end of the 
dipole and an insulator in the center where 
we'll attach the feedline. 



Figure One 
(the dipole) 



T 



A dipole is one half wavelength long which 
is the distance from point A to C . A 
wavelength depends on the frequency we're 
trying to operate at. Since different fre- 
quencies have different wavelengths we'll 
need to do two things in order to build our 
dipole. First, what frequency will we be op- 
erating at? And second, how long is a half 
wavelength at that frequency? 



For the first item, let's build our an- 
tenna so it operates at 28.5 MHz. In order to 
discover the second item we ' ] 1 need to start 
by learning what a wavelength is. 

Figure Two 

(two waves on a line) 
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Every frequency has a corresponding wave 
length. Frequencies are measured in Hertz, or 
cycles per second. A wavelength is the length 
of wire it takes for one wavt, or cycle, of a 
given frequency. Figure 2 shows two cycles, 
or waves, of a frequency. The first cycle is 
from point A to point. C. The second is from 
point C to point E. 

Since we're building a half wavelength 
antenna, we only need to know how long half a 
wavelength is. There's a formula that allows 
us to calculate a half wavelength if we know 
the frequency. 

Length (ft) = 492/frequency (MHz ) 

The MHz in parenthesis stands for Mega 
Hertz. We already know that Hertz is cycles 
per second. Mega means million. A fre quency 
of 144 MHz is a short way of saying 144,000, 
000 cycles per second. 

The formula can be entered directly to 
calculate the length of wire needed for a 
half wavelength antenna, but it's more fun to 
use a short program (Figure Three). 

10 CLS:W=0:F=0 

20 INPUT "FREQUENCY ( MHZ } " ; F 
3 0 REM PRINT i! A HALF WAVELENGTH 
ANTENNAE WILL" : PRINT " BE ";492/F; 
" FEET LONG" 

34 W=492/F:FT=INT< W) :IN=(W-FT)*1 
2 




tustler: Keep the covpoke froa stinging froa the gallon in 
this word guessing gaae. PIDDE3 graphics designed to be at 
tracti?e on both aonocbroae and color Screens and good Sound 
Make this an enjoyable challenge. Includes editor prograa to 
create your own word lists. (5.00 



Blip: 



Test your aeaory and try to repeat the segue: 
flashing squares and tones. Increasing levels of difficulty 



oi 



aake this gaae a true challenge 



13.00 



Tippee: 

gaae. 

faaily. 



Try to get the best score in this f and liar poker dice 
Op to nine players sakes this gaae fun for the entire 

13.00 



Sped*!: All three Jaass #8.00 
all gaaes are in BASIC. 32K Extended Color Basic™ required. 



Real lersion 2.0: toe your DMP printer to create per- 
sonalized calendars froa 1986 on. Each day has three lines 
of 15 characters each available for your on personal notes. 
901 machine language for fast response. 321 Extended Color 
Basic required. 16.00 

All prices are cassette or disk. Canadian wmey saaa as O.S. 
AH others O.S. funds. Washington state residents add 7.52 
sales tax. All shipping and handling included. 



Send check or aoney order to: 



ling Cottar Industries 
I8l! falley St. ~ 



Poulsbo, 94 



n 

88370 



EKtended Color Basic is a registered trademark of Tandy Corp. 
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3 5 PRIN'I "A HALF WAVELENGTH ANTE 
NNAE V J L L ' : PRINT" BE 11 ; FT: "FEET " 
; IN ; "INCHES" 
40 PiUNT "AGA j N ."' ; 
5 0 A$ = IN KEY'S : if A3>=" " THEN 50 
GO IF A$ = "N" OR AS = ,; n" THEN END 
ELSE 13 



Let ' 



s practice using the program by cal 



culating the length of an antenna for a 
frequency of 10 MHz. I came up with 49 feet 
2,4 inches. Your result should show the same. 

Since we're going to build the dipole to 
operate at 28.5 MHz use the program and dis- 
cover how long our antenna should be. 
According to my calculations our antenna 
should measure 17 feet 3.15 inches in length 
(I rounded it a little). That's the length 
from point A to C in Figure One. 

Now that we know the length of our 
antenna, cut a piece of wire to that length. 
Attach insulaLors to each end of the wire. 
Find the center of the wire (point B in 
Figure One) and place another insulator there 
by cutting the wire. Connect the center con- 
ductor of the coax to one side of the dipole 
and the shield to the other side. 

The coax I'm using is 50 ohm coax which 
can be purchased at Radio Shack (along with 
everything else here). The impedance of the 
center feedpoint where the coax is attached 
is 75 ohms. This means that, even under ideal 
conditions, we will always have a 1.5 to 1 
mismatch (75 is 1.5 times 50). 

Connect the antenna to your radio with an 
SWR bridge (meter) in line. You'll only need 
to do this SWR check if you will be trans- 
mitting. If you're .just listening in (reading 
the mail) don't worry about the SWR. We're 
going to measure the Standing Wave Ratio of 
the antenna and 'prune' it to resonance. Even 
though we used the formula and program to 
tell us how long the wire should be for our 
antenna, it still must be checked and trimmed 
to get the best possible match. This is be- 
cause the formula calculates ar antenna's 
length in free space. The actual length of 
the antenna will be affected by it* proximity 
to other conductive or semiconductive ob- 
jects . 

Measure the SWR and trim the antenna at 
the ends (points A and C) by removing about 
an inch at a time from the length. Be sure to 
remove an equal amount from both ends! After 
each trimming measure the SWR again until you 
reach 1.5 to 1. Once the antenna is trimmed 
it can be used on the air. 

Well, our dipole is built and seems to be 
working pretty well. Next time we'll add to 
our program and learn how to build a three 
element beam! Now that's exciting! 73 's de 
Mike Dooley KE4PC 
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Pseudo code: sort of an outline in English of 
the different parts of the program and what 
you want them to do. 



printfactsl ) ; 

A function must be defined someplace, at the 
end of the source code or included in a 
1 ibrary . 

Argument: a value that is passed to a func- 
tion. EX getfacts(list) ; The value can be a 
single digit to a string. A function can have 
no arguments, (but you always include the 
parenthesis), or multiple arguments. EX 
add(a,b,c,d,e ) ; 

Library: There is a standard library that 
comes with the C Compiler. It can be changed 
and added to. This Library includes all the 
I/O functions like printf ( ) in relocatable 
object code . 



Source code: the program, in readable C, be- 
fore it has been compiled. 

Object code: the product of the compiler; the 
program translated into machine code. (Ah, 
the light dawns! The same source code run 
through different compilers produces machine 
specific code. That's how you get port- 
ability. ) 

Relocatable object code: Object code after 
the compiler has translated the source code 
into machine code but the memory addresses 
have not been absolutely defined; only the 
offset (or relative) information is kept. 
The most common example would be Library 
functions before linking. 

Linker: the last step in compiling a C pro- 
gram; this is when the Library relocatable 
object code is added to the program. At this 
time the actual addresses are created for 
that program. 

Function: These are C's building blocks. 
Every program must have one and only one 
main( ) function that starts the program. 
When you see source code without main( ) , you 
know that it is intended to be used within 
another program. You can use functions that 
are already defined in a Library; you can 
create your own library of functions that you 
use in programs over and over again; or you 
can create functions for a specific program. 
EXAMPLE main( ) 

getfactsf ) ; 

sortfactsl ) ; 



Compile time: what happens while you are 
running your source code through the com- 
piler ... usual ly errors, frequently fatal. 

Run time: what happens when you are running 
your program after compilation . . . sometimes 
unexpected . 

Debug: when you change your source code to 
get rid of the errors. 

(Then there is object-oriented programming 
that the slick magazines are talking about. 
This appears to be a way of defining classes 
of things hierarchically so that you propose 
actions related to the class before defining 
the unique object that will be affected. C++ 
is the language that handles data abstraction 
and object-oriented programming.) 

SOURCES 

All this, of course, is dependant upon a 
compiler. Microware's C Compiler for OS-9, 
published by Radio Shack can be obtained 
through Express Order at most Radio Shack 
stores for $99.95. (Cat. # 26-3038 CMC) In 
addition, there are various shareware and 
public domain compiler offerings on Compu- 
Serve and the like. 

A very helpful addition to the compiler is 
the C-Programmer 1 s Tool Kit, #9 from the OS-9 
User Group Library. The command cb is a 
pretty printer. If you type your source code 
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Version 2 of CSG IMS has been delayed but you should 
receive it by the time you get this newsletter. 

MSF 

The source code for MSF is now available for those who 
are developing MS Dos disk drivers for other OS9 computers. 
The price is $45. 

Users of MSF (the MS Dos file manager) are still en- 
countering problems when accessing an MS Dos disk as an 
OS9 disk. The most common mistake is when an MSDos disk 
is referenced by the OS9 drive name. For example: DIR /Dl 
instead of DIR /B (NOTE: there is a new version of MSDIR 
renamed to DIR which will work with both OS 9 and MSDos 
disks). Another mistake is to leave a default directory on an 
OS9 disk and then replace it with an MSDos disk. When a 
command cannot be found or you forget to specify the drive, 
the default directory will be accessed. 

As discussed in a previous newsletter, these problems 
occur because OS9 and MSDos use a different disk sector 
size. When an MSDos 5 12 byte sector is read into an OS9 256 
byte buffer the buffer overflows into system memory. In the 
worst case this will cause a system crash but it could create 
other havoc as well. 

The OS9 file manager which allocates the buffers for OS9 
sectors (256 bytes) is RBF. If we patch RBF to allocate 512 
byte sector buffers so system memory will be protected (ex- 
cept from Japanese MSDos disks which use 1024 byte sec- 
tors). More system space will be used for file buffers so you 
may not be able to run as many processes or windows or have 
as many files open. This example is for the following version 
of RBF. 



OS9:ident rbf -m 



Header for: 
Module size: 
Module CRC: 
Hdr parity: 
Edition : 
Ty/La At/Rv: 
File Man mod, 



RBF 
$122E 
$EFBE13 
$D4 
$1C 
$D1 $81 
6809 obj, re-en, 



#4654 
(Good) 



#2 8 



R/O 



The BOOTPATCH command will patch the boot file and 
update the CRC. You should run BOOTPATCH on a backup 
of your system disk because if you make the wrong patch, 
your disk could become non-bootable. 

Place your system disk in drive /d0 and your backup sys- 
tem disk in /dl. Make sure you have the BOOTPATCH 
program (you will have to enter and assemble the program 
listing below) in your CMDS directory. Enter the following 
commands. 

OS9:bootpatch /dl/os9boot #40k 

1 rbf 

c 2bb 01 02 
c 73b 01 02 

q 

OS9: 

Now boot the backup system disk so RBF will allocate 512 
byte buffers for all files. 



NEWSLETTER 

If you have a different version of RBF you can still make 
the patch if you have a disassembler or debugger such as 
ERINA. Simply find the two places in the code where there 
is a LDD #$0100 followed closely by an OS9 FSSRTMEM 
and an OS9 F$SRQMEM. Use BOOTPATCH to change 
LDD #$0100 to LDD #$0200. NOTE: On the Smoke Signal 
V AR computer theOS9 calls in RBF may be JSR instructions. 

« Bootpatch.a - patch a module on disk * 

* (c) Clearbrook Software Group 

* Date; October 1988 

* Author: Paul Kehler 

ifpl 

use /defs/os9def s 



Edition equ 1 

LF equ 10 line feed 

CR equ 13 carriage return 

SP equ 32 space 

BuTSIZS equ 256 



mod raodlt 



PRCRM+OB JCT , RELENT + 1 , mods t r t . mens i z 



file rmb 1 path number 

chflag rmb 1 NE means CRC needs update 

rewrite rmb 1 NE means file needs update 

offset rmb 2 change offset 

oldval rmb 1 value to change 

newval rmb 1 new value 

module rmb 2 address of module in memory 
filend rmb 2 pointer to end of file buffer 
filesize rinb 2 size of file 
buf rmh BUFSIZE 

filebuf rmb 2(500 actually to end of memory 
stack rmb 200 
raemsiz equ . 

mcdstrt clra the start of the program 
clrb 
stb 

stb <chflag 
stb <rewrite 
modstO ldb , x+ 
cropb #CR end of name? 
lbeq modst2 ..yes, no options 
cmpb *SP 
beq modstO 
cmpb * ' - 

beq modstl ..chock option 
leax -l,x 
tst <file 

bne twonames ..two file names 
Ida #3 open for update 
OS9 ISOPEN open the file 
bcs error 
sta <file 
ldb #SS.Size 
pshs x 
pshs u,x 

OS9 ISGETSTT get file size 
bcs error ..report error 

3tU , S 

ldu 2 r s 

stx -2,s is file too large? 

bne nomem . .yes 

idd ,s get file size 

std <filesize 

leax filebuf, u 

stx <module default link to first module 
addd <filesize 

bcs nomem ..not enough memory 

std <filend save pointer to end of file 

addd »2D0 

bcs nomem ..not enough memory 
pshs d 

craps , S++ is there room for the stack 

bio nomem ..not enough memory 

ldy , s get file size 

ldx <module get buffer pointer 

Ida <file 

OS9 I 5 READ read the file 
bcs error 
ldd ,x 

cmpd #$8?cd is it module? 
bne badfile 
leas 4,s 



puis X 

bra modstO 
nomera leax moremera, per 
nomeml bsr writeln 

clrb 

OS9 F$EXIT 
badfile leax notmod, per 
bra nomeml 



modstl ldb , x+ 
cmpb #CR 
beq mod st 2 
cmpb #SP 
Ibeq modstO 
cmpb I ' ? 

beq modsyn . .yes, 
lbra inodstO 



report syntax 



twonames leax naraerr,pcr 

bsr writeln 
modsyn bsr syntax show command syntax 

clrb • 
error OS9 F$Exit 

syntax pshs x, b 
leax synmsg, per 
bsr writeln 
puis x.b.pcr 

writeln ldy *synlen 
Ida *1 error path 
OS9 l$writln 
rts 

skipsp ldb , x+ 
cmpb *SP 
beq slcipsp 
lbra toupper 

skipspl bsr skipsp 
leax -1,31 
rts 

ra0dst2 tst <file was a file specified 

bne modst25 . .yes 

leax nomsg,pcr 

bsr writeln 

bra modsyn 
modst2S leax buf.u point to buffer 

ldy *BUFSIZE 

clra 

os9 ISREADLN read a command 
bes errorl 

bsr skipsp skip leading spaces 
cmpb #'L is it link? 
Ibeq link 
cmpb * ' C 
beq change 
cmpb J'Q 
beq quit 
cmpb #CR 
beq modst25 
leax unknown, per 
modst28 lbsr writeln 
bra modst2 5 

errorl cmpb #E$EOF is it end of file? 
beq quit . .yes, quit 
OS9 FSEX1T 

quit bsr changed check if module was changed 
ldb <rewrite has any change been made? 
beq quit9 . .no 
Dsns u 
ldx to 
tfr x,u 
Ida <file 

OS9 ISSEEK rewind to beginning of file 
puis u 

bes quits . .error 

leax filebuf, u point to data 

ldy <filesize 

OS9 I$WRITE write the file back 

bes quit9 
clrb 

quits OS9 FSEXIT 

* update the crc of changed module 
changed pshs d,x,y,u 

ldb hflag has module changed? 

beq changed9 . .no 

stb <rewrite file needs update 

clr cchflag next module not changed yet 

ldx <module 

Ida is 

clrb 

changedl eorb , x+ find header parity 
deca 

bne changedl 
comb 

stb ,x update header parity 
ldx <module 

ldd 2,x get module size 
subd #3 

leau d,x point to crc 

tfr d,y module size less accumulator 

ldb #$FF 

stb ,u 



stb l,u 
stb 2,u 

OS9 F$CRC calculate the new CRC 
com ,u 
com l.u 
com 2, u 
changed9 puis d,x,y,u,pc 

change bsr gethex get offset 
lbcs modst25 
std <offset 

bsr gethex get old value 
lbcs modst25 
stb <oldval 

bsr gethex get new value 
lbcs modst25 
stb -cnewval 

ldx <module point to module 
ldd <offset 
cmpd 2 , x 
bio changel 

leax outofrng.pcr .. offset out of range 

lbra modst28 
changel leax d.x point to byte to change 

ldb <oldval 

cmpb , x 

beq change2 

leax diff rent, per 

lbra modst28 ..print warning 
change2 ldb <newval 

stb ,x 

ldb *1 

stb <chflag set flag 
lbra modst25 

gethex clr , ~s 
clr , -s 
lbsr skipsp 
cmpb *CR 

beq gethex25 ..no number 
gethex21 cmpb #CR 
beq gethex29 ..number complete 
cmpb #SP 

beq gethex2 9 . .number complete 
cmpb * ' 0 

bio gethex25 ..error 
cmpb I ' 9 

bis gethex22 . .0-9 

andb t$5f convert to upper case 

cmpb *'A 

bio gethex2 5 ..error 
cmpb # ' F 

bhi gethex2S ..error 
subb f'A-'O-lO 
gethex22 subb t' 0 
lsl l,s 
rol , s 
lsl 1, s 
rol , s 
lsl l,s 
rol , s 
lsl l,s 
rol , s 
orb 1 , s 
stb l,s 

ldb , x+ get next character 

bra gethex21 
gethex2S leax hexmsg,pcr 

lbsr writeln 

comb set carry 
gethex29 puis d,pcr return hex value 

link lbsr changed check if module changed 

lbsr skipspl 

pshs x 
linkO ldb ,x 

cmpb #SP 

bis linkOl 

bsr toupper convert name to upper case 
stb ,x+ 
bra linka 
linkOl ldb -l,x 
orb *$S0 

stb -l,x set hi bit on last byte 
leax filebuf, u 
pshs d,x 
ldd ,x 

cmpd #S87cd is it proper module? 
bne link99 . .no 
linkl stx , s save pointer to current module 
tfr x, d 

addd 2,x get module siEe 
std 2,s point to next module 
ldd 4,x 



leax d.x point to current module 
ldy 4, s link name 
link2 ldb ,x+ 
bsr toupper 
cmpb , y+ 
bne link3 
tstb 

bpl link2 

ldx ,s ..module found 
stx <raodule 
leas 6, s 

lbra modst25 go for next command 
link3 ldx 2,s 

cmpx <filend is it end of file? 

bio linkl try next module 
link99 leax notfound.pcr 

leas 6,s fix stack 

lbra modst2 8 and go report error 

* convert B to upper case 

* bit ? not affected 
toupper pshs b 

andb #$7f mask bit 7 
cmpb # ' a 
bio toupperl 
cmpb *' z 
bhi toupperl 

andb *$5f convert to upper case 
toupperl orb *$80 set hi bit 
andb , s+ 

rts 



unknown fee "Unknown 
feb CR 

moremem fee "Not enough memory to load 
file ! " 
feb CR 

naraerr fee "Only one file allowed!" 
feb CR 

nomsg fee "No file specified!" 
feb CR 

hexmsg fee "Non hex character encountered! 
feb CR 

outofrng fee "Offset is not within module! 
feb CR 

diff rent fee "*« old value not the same, 
not patched **" 
feb CR 

notfound fee "Module not found!" 
feb CR 

notmod fee "File does not contain 
module (s) ! " 
feb CR 

synmsg 

fee "Syntax: bootpatch [opts] <filename> 
lopts]" 
feb LF 

fee " where opts are: -? 
fch LF 

fee " <filename> is the 
containing the module to" 
feb LF 

fee " be patched. NOTE: 

different from MODPATCH" 
feb LF, LF 

fee " Commands: L <module> 
specified module in the file" 

feb LF 

fee " 
<new value> 

feb LF 

fee " 
value." 

feb LF 

fee " 

feb LF, LF 

fee " The CRC of the module will be 
automatically updated when you link" 
feb LF 

fee " to a new module or quit." 
feb LF, CR 



link to the 



C <offset> <old value> 
change the old value" 



at offset to new 
quit" 



synlen equ "-synmsg 

emod 
modlen equ * 

end 



Clearbrook Software Group 



BOX 8000-499 BOX 8000-499 

Sumas, EA Abbotsford, B.C 

U.S.A. 96295-8000 CANADA V2S 6H1 
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without indentations and commonly accepted 
spacing, you can then send it through cb, and 
lo and behold, it is all formatted for you - 
which also points up errors. 

The command lib will split up the Library 
into the separate relocatable object files so 
that changes can be made. Other neat commands 
are findfunc, which goes through and finds 
all your functions for you, and xc , a "C" 
concordance utility, that helps you sort out 
what you have . 

The report on FoxWare CCENV(R) will have to 
be delayed, as I have not received my copy 
yet . 

ODDS AND ENDS 

Donald Hicks of Mobile, Alabama writes that 
what he really wanted to suggest was to 
change "/dl" to " . . . " "so that reference is 
made to the ( anomymous ) root directory under 
all circumstances - probably the best alter- 
native (so as to keep it portable)." He adds 
the warning "that this might not be true if 
your C stuff is down in some subdirectory on 
your hard disk somewhere." 



search for the way to split between the 
screen and the printer; then he had a long 
search for the actual code for his computer 
to printer. When I saw what he had come up 
with, I knew that under OS-9 it was all so 
easy Lo know how to go to the printer. Now 
the next thing that could be done is to 
change the program so that you input amount 
borrowed; monthly payment; number of total 
payments to be made and let it back out the 
interest and how much of the payment is going 
for interest and how much for principal. That 
is usually the question I want answered. 

Walt brought his machine to local C SIG 
meeting to demonstrate his compiler. I was 
interested in the bells and whistles avail- 
able on other machines. When he runs the 
compiler, the application comes up in a nice 
menu, highlight selectable. But most inter- 
esting, as it compiles the code, it does a 
"dump" of the hexadecimal code. 



+*♦*★** ft**************************************** 
+ NEW ** NEW ** NEW ** NEW ** NEW ** NEW ** X 



PLANS FOR AN OUTLINES 

Those of you who want a challenge (and even 
if you don't), please think about an outliner 
....a simple outliner, more like PC Outline 
than like Think Tank in the beginning. Please 
send pseudo code describing how you would go 
about some aspect of the program; include a 
couple of functions to illustrate your pseudo 
code . 
Send to: 

Nancy Ewart 

Book Trader ( SEEC ) 

1789 Hooper Ave. 

Toms River, NJ 08753 

This source code, written for a TRS80 Model 
4, was interesting to me as a challenge in 
porting code from one machine to the CoCo. 
But there is more to the program than just a 
simple loan calculation. Walt has been play- 
ing around with code that sends output to the 
screen AND output to the printer in the same 
code. When he found out how to do it on the 
Model 4, it was simple to figure out how to 
do it in OS-9. 

This is Walt Gabriel's code as he wrote it 
for his machine and his compiler. 

On line 42 change perror to ferror 
Delete line 62 

I just dropped out all references to date and 
time for the nonce. Actually there were very 
few changes that were necessary. Because I 
wanted to make this usable for any kind of 
loan, I changed some of the terminology to 
the more generic word LOAN. Walt had to 

30 



* VED OS-9 Text Editor * 

I t 
J Haven't you been fooling with line editors * 

* written for someone using a Teletype long* 

* enough? Or did you get a mickey mouse editor * 

* written in a high-level language which does J 

* screen refreshes so slowly that you can count * 

* the characters as they are printed. Well fret * 

* no more — VED is here! Our amazing new editor * 
X is less than 8k long, but since it is written in *. 
X fast f efficient 6809 assembler and takes* 

* advantage of QS~9 r s system resources it lacks * 
♦no features* 52,000 character buffer;* 
Joverstrike/insert mode; adjustable tabs;* 

* definable (and saveable) macro keys; word* 

* delete; block move, copy and delete; auto- * 
J indent mode, global changes, plus much more- J 

* VED is not a word-processor, but formatting* 

* commands will let it be used to do letters, * 

* etc. (however, the best route is to use one of J 
J the many text formatters available). I/O* 
+ commands include block save/print, append, etc. * 
X All files are ASCII for complete file* 

* compatibility. But that's not alls everything J 

* VED does is FAST. No more delays! And the* 
+ single key-stroke commands are very easy to* 
X learn; but if you forget on-line help is* 

* available. * 

* * 
X 128K OS 9 Level 2 *24.95 X 

* * 

* * 

* Sorry, no credit cards — enclose check or money* 

* order plus $2.00 shipping and handling. Complete* 
X catalogue available — send *1.00. X 

* * 

* + 

* Bob van der Poel Software * 

* 17435-57 Avenutr X 
X Edmonton, Alberta * 

* Canada T6M 1E1 * 



001:/* ZMORT1/CCC 09/11/88 */ 

002:/* This is, a DEVELOPMENTAL version */ 

003:#include stdio/h 

004 : #include math/h /* Required for atof ( ) */ 
005 : main( ac , av ) 



006: int ac ; 

007: char *avl } ; 
008: 

009: float in = 0; 

010: float pay = 0; 

011 : float loan ■ 0; 

012: float >ipd = 0; 

013: float ppd = 0; 

014: int i = 1; 
015: 

016: long tod; 

017: char buf 1 [ 81 ] ; 

018: char tbuf (9j ; 
019: 

020: FILE *ptr , *f open( ) ; 
021 : 



022:/* initialization of tbuf and &tod */ 
023:sysdate( tbuf ) ; 
024:time(&tod) ; 
025: 

026:pay = atof (av[l J ); 
027 : in = atof (av[2 J ) ; 
028:loan = atof (avI3] } ; 
029: 

030:/* Information to be on screen */ 

031 :puts( "Written by Walt Gabriel, 20 Wren Place, Toms River, N.J., 08753"); 

032:puts(" 201 240-5084"); 

033: 

034 :strc P y(bufl , ( FILE„)); /*dis@pays file name */ 

035 : strcat( buf 1 , "Compiled on "); 

036:strcat(bufl , ( DATE ) ) ; 

037:puts(bufl )'; 
038: 

039:if (ac == 4) /* Note count is 4 - 0,1,2,3 */ 



040: 

041: if ((ptr = f open( " *pr " , "w + " ) ) -= NULL) 

042: perror ( " f open error"); exit(-l); 

043: fputs( "MORTGAGE PAYOUT TABLE", ptr); 

044: fputs(" \n\n",ptr|; 

045: fprintf (ptr , "Original Loan Value %8 . 2f \n" , loan ) ; 

046: fprintf (ptr, "Annual Interest %6 . 2f \n" , in) j 

047: fprintf ( ptr, "Monthly Payment %6 . 2 f \n\n" , pay ) ; 

048 : 

049: fputs( "PAYMENT PRINCIPAL PRINCIPAL INTEREST W.ptr); 

050: f puts ( "NUMBER REMAINING PAID PAID \n\n",ptr); 

051 : 



052:while (loan >=0) 

053: 

054: 

055:/* computation */ 



056: ipd = loan * in/1200; 

057: ppd = pay - ipd; 

058: loan ~ loan - ppd; 
059: 



060:fprintf (ptr," %d %8.2f %6.2f %6.2f \n" , i++ , loan , ppd , ipd ) ; 

061 : 

062: f puts (c time (itod), ptr; /*prints date, time */ 
063:fclose(ptr) ; 
064 : 

065 :else 



066: puts("DATA ENTRY FORMAT \ n ") ; 

067: puts("DMORTPAY PAYMENT/MONTH ANNUAL INTEREST LOAN\n" ) ; 

068: puts ( "EXAMPLE: MORTPAY 132.98 8.5 5000 \n" ) ; 
069: 



070 : 

071 : 






Here are the changes that I made so 
CoCo . 


that 


the source code would compile on my 


On line 003 #include <stdio.h> 
On line 004 #include <math.h> 
double atof( ) ; /*between lines 13 


&. 14 


*/ 


Delete lines 16, 17, 18 






pffinit(); /* insert on line 21 */ 






Delete lines 22, 23, 24 






Delete lines 34, 35, 36, 37 






On line 41 change ,, *pr" to "/p" 
On line 42 change perror to terror 






Delete line 62 
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$83.25 
SAVE 15% FROM LIST PRICE 

Just in time for holiday giving it's 6-2-1! 
"6-2- 1 " is our new program to save your 
money! Six back issues of Clipboard, a two- 
year subscription to Clipboard and one year 
ot ClipOisk. Normally $97 97, now you can 
save 15%, only $83 25! Just write in 
"6-2-1" on the order form on page 18. 
MC - Visa - Discove r accepted. 



And now you can phone in your order! 
We accept VISA, MasterCard and 
Discover - (716) 679-0126 — 9 a.m. 
to 9 p.m. Monday thru Saturday! 



EH 



SPECIAL DEAL ON 500 
PROGRAMS IS BACK! 



BACK BY POPULAR DEMAND! GET OUR LATEST 
50 DISKS OR TAPES FULL OF OVER 500 PROGRAMS. 
HERE IS WHAT YOU'LL RECEIVE; 

★ Over 250 Utility/Home Application Programs including a 
Word Processor, Database, Spreadsheet, Disk Utilities, 
Business Software, Electronics Series, Educational Pro- 
grams for Kids, plus much more! 

★Over 200 exciting games including King Pede, Kron, Star 
Trek, Flight Simulator, Wizard, Horse Races, Football, plus 
much more. 

★ Over 30 adventures including Rambo, Haunted House, 
Power Sword, Skid Row, plus 32k graphic adventures. 

Individual issues sell for $ 9 00 each or s 450 00 
for all 50. We slashed the price to 
only s 15u 00 ! 



COOL LX)WNT0 OUR SUMMER PRICES 
ON SUBSCRIPTION SOFTWARE 



THERE IS NO BETTER WAY TO EN, JOY THE SUMMER THAN 
TREATING YOUR COLOR COMPUTER TO 10 READY-TO RUN 
PROGRAMS EACH MONTH GET 12 DISKS OR TAPES A YEAR 
CONTAINING OVER 120 QUAL ITY PROGRAMS A SUBSCRIPTION 
TO T & D SOFTWARE CONSISTS OF 10 READY-TOT OAD PRO- 
GRAMS DEL IVERED BY FIRST CLASS MAIL EVERY MONTH 

NO, WE ARE NOT THE SAME AS THE RAINBOW ON TAPE IN 
FACT, MANY SUBSCRIBERS HAVE WRITTEN IN AND SAID THAT 
WE ARE MUCH BETTER THAN RAINBOW ON [APE! 



REG. $ 450 




$ 150 ( 



★ ★THIS MONTH ONLY** 



Buy this package of 500 
programs and receive a free 
6 month subscription. 




PRICES 

TAPE THIS 
OH DISK MONTH ONI Y 
1 YEAR (12 issues) JQiKf 60 00 

6 MO (6 issues) W.tJtf 25 00 

1 1SSUE *.<W 8 00 

Michigan Rowdedli Add 4*.g 
OiisrsOdS Aria SiO lu Subscription Pritfc 
PwswKii Cnttii!, Wb'corne 1 



RAINBOW 



taut-b Available rioiii 
uly '82 (Ovu 720 Programs) 



PLEASE SPECIFY TAPE OR DISK 



T & D SUBSCRIPTION SOFTWARE, 2490 MILES STANDISH DR., HOLLAND, Ml 49424 (616) 399-9648 
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T&D Subscription 
Software, 

an advertiser 
in this magazine, 

wants to introduce you 
to their variety of 

inexpensive software 
by giving you a: 

FREE Disk or Tape 

Filled with 10 programs 

1 coupon per household 

Circle one: TAPE DISK 
Mail this coupon to: 

T&D Free Offer 

P.O. Box 1256 
Holland, Ml 49423 




STOCK MARKET PORTFOLIO 
FOR THE COLOR COMPUTER 



Saym 1&'L on Stock 
Market Porfolio with 
this Clipboard Coupon 



Paparis Enterprises 
700 York St. 

Williamsburg, VA 2318: 



MARTY '5 RUBBER STAHP DISCOUNT COUPON! ■ 

.' ■ 

tie can now offer COLORS for many nylon cartridge 
ribbons. Our RAINBOW-PAK contaip 6 different 
ctJlored ribbons. Write for prices. Specify your 
printer's name & model. 

Marty ' s Rubber Stamp Shop 
47 South Second St. 
SAINT CLAIR, PA 17970 
{717} 429-1052 



o" 2 
g.5°S 

CO u t- s 

H a> a a 

ca*a ao 
a 

c u a 

Q9I -H 

"0 * 5 m 
5-PO.Q 
ed«w 3 

CO CO o 

<J t- 

• o ao 
oa o i» 

X H« 
0*4^ 



0 a c 

«• s S 



U 

PS 



Sava lBX on C.S.B. 
— - with thi« coupon — 

Clearbrook Software Group 



Information 

Management 

System 



CSG IMS is a full featured relational database manager 
lor Ihe Color Computer and 0S9. 

. U*»r <)»tln»d iCTwr> «rvd 
». rspon formttm. 

• Rreord. IikJm. nit thai 



Tenl. BCD tlontino poinl 
<Mdtgll»). thou W long 
lnt»o«. uu) on, did typM. 

CSO IMS lor CQC02AJ OSS U/2 (tln 0 t« uwr) * 169 93 

CSG tMS (or OS9 15 or 68000(<nulU uwr) l<35 w 

CSQ IMS darno vrilh manukl *30 00 

OTHER CSQ PRODUCTS: 

ERJNA Symboltc U»»r^nod* D»tHioo«r for OS9 Ua oQ 

SERIN* Sytt« m-modt Debugger lorOS9L«v»!i 1 1 39 00 

MS* MS-DOS Fh M«niig.r tor C0C0KOS9 U j«.ao 

MSFwIMl SD'SK3 t65.00 

Shipping - N. *m«rle»: ts, O.....M. ttO 
Clearbrook Software Gro.ip, Inc. 
U.S .: P.O. B©*800CM99, Summ,WA 98295 
CANADA: P.O. Bo, MOO-499. Abbourord, B.C. V2S 6H1 
Phone: (604)853-9118 
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SAVE $15 
WITH THIS COUPON 

ON A SCSI INTERFACE 
WITH R.T.C. 

OR $15 ON A 2 CHANNEL 
DUAL COMM BOARD 

FROM: 



KEN-TON 
ELECTRONICS 

187 GREEN ACRES RD. 
TONAWANDA, NY 14150 
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KIHG COTT AGE IND USTRIES 

Include this coupon with any 
order before Christmas and 
receive one free blank diskette 



Save $5.00 on 

RAD. PRODUCTS 



Text form 



Exp. 12/31/88 



CCMDisk Service 



PRESENTS 



Hate typing in 
those 1-o-n-g program 
listings? Don't worry, 
he Happy! Subscribe 
to ClipDisk today 



\ 



ClipDisk 

FULL YEAR (6 issues) Only $49.95 ! 




Now all the BASIC , C, BAST CO 9 , Assembly Language and 0S9 
programs you see in Co Co Clipboard Magazine are available on 
disk. With ClipDisk you* 11 save time and be more productive 
c o mpu ting with y o u r C o 1 o r C o mp u ter. 

A subscription to ClipDisk is $49.95 for 6 issues. Single 
issues are available as well for just 39.95. Of course in 
order to get the full benefit of ClipDisk you'll need t he- 
corresponding issue of CoCo Clipboard Magazine. A.I.I. 
CI ipDisks are mailed first class. 



\ 



So don't delay, get your subscript ion j n today! 



I've enclosed (check one) ( ) 1 year of ClipDisk $49.95 

( ) single copy 9.95 

Specify month desired 



Canadian customers can also obtain ClipDink for $49.95 
when paid in U.S. Funds. 



Name: 

Address: 

City: 

Stnte/Prov: 

Zip/Postal Code 



Just. 



time for holiday giving It's 
6 2-1! "fl-2-1" Is our new program to save 
your money! 5 bock Issues Of Clipboard, a 
2 yraar subscription to Clipboard and t 
year or ClipOisk. Normally J97.9S now you 
can save 15X only ♦83.25! Just wrttfi in 
"5-2-1" on tlx* order form on page IS. 



J 



J WC-Vtsa-D i| Iscqver .accented. J 



Plc-aso cbfirgn my purchase to my (ciide) VISA I MasterCard / Discover Card. 
MasterCard Interbank Number I 



VISA 



:^3^' 



Card « _ _ 

Exp. Date 

Signature 

PLEASE N01 E: All charge card orders are handled courtesy of On line Computer Services. Your 
charge card hilling will show On-line Computers and NO! CnCo Clipboard Magarine 



CoCo Clipboard Magazine 

7>7M. U.S. 20, Box 3. Fredonlfi. riY 14063 



The Gamer's Connection! 



The ONL V magazine devoted so/e/y to the CoCo gaming worfdf 




The Gamer's Connection, a great 
new magazine devoted solely to 
the Color Computer world is 
finally here! Filled from cover to 
cover with high quality programs, 
articles, tutorials, advice, hints 
and tips, reviews, and more 
reviews - The Connect/on is 
truely the best and most current 
source of CoCo information 
anywhere! Also found inside are 
columns on BASIC programming, 
machine language instruction, 
program design, and so much 
more! All presented to you in 
enjoyable and clear fashion... 



Right now you can take advantage of our introductory 
special and save on our subscription rates. You can 
receive a full year (six issues) of The Gamer's 
Connection for only $15.00 ($18.00 Canadian residents 
(US funds)). This special offer is in effect only for a 
very limited time, so act now and start your subscrip- 
tion to The Gamer's Connection today! 



Please send your check or money order to: 

The Gamer's Connection - Dept. C, P.O. Box 102, Grafton, Wl 53024 



Real BASIC for 0S9! 




OS-9 LEVEL TWO VR. 02.00.01 
COPYflfCHT 1988 BY 
Ml CROW ARE SYSTEMS CORP. 
LICENSED 10 TANDY CORP. 



July 11, 1UI I4.3r.30 



OS«: Imoda Mi 
054; Inlz fe» 
OS»: rib <»>^ws 
t007 



DISK EXTENDED COLOR BASIC 2.1 
COPH. ISM. ISWti BY TANDY 
UNDER LICENSE FfiOM MICROSOFT 
AND M.CROWARE SYSTEMS CORP. 



LOAD "DfuO- 

OK 

LIST 

10 PMOOE 4:SCREEN 1,1 

20 X=RND(256)-1:Y.RND(1B*)-1 

M XS^RNDiJSS-Xl-^YS^RNDtlSr.Y)-! 

40 LINE (X.*H*t«.»i«).PSET,BF 



Welcome to . 



R. S. B 



S.» R S B. and othar Burka A 
Burka product* at tha Prlnoalon 
Don't tub* our Hard 
Olak Samlnar! 



JSSHS ^Z^SW^tX^T^I^' 10 "■ ne BASIC *°" kn °» to " " "°» 

Burke & Burke is proud to present another OS9 programming language: Disk Extended Color BASIC. 

REN^^^ ' m S 6 ? m Vp^ Color Computer was born with. We're talking PMODE, DIR. COLOR, 

RENUM, PLAY and other familiar words. Under Level 2 OS9. In as many windows as your memory lets you create. 

D Ur L- R '?-r?' ^ oftware ™ a } es a complete, OS9-compatible version of Disk Extended Color BASIC by reading your CoCo's ROM chios 
n S™ihW a h3S addQd n8W S0ftW ^ 6 10 OS9st y ,e 9 ra P hics - *>"nd. Fin^r. and disk l/d Of course you can^ use RS 1 to 

run machine language programs, and some BASIC commands work slightly differently under R.S.B. 

Os4 B a nd a RAqrr d Hkk? S y^r^i? 89 ' 8 ,Ne f ° rmat ; f W 5" ve a,SO in ? luded ^ tilities t0 transfer BASiC programs and data files between 
and fa *MHz oration Programs can take advantage of great 0S9 features like hard disks, no-halt floppies, multi-tasking, 

rTr^ rfioc q^ 0 ? 3 witl i a J 'rj ast 1 28K RAM - and a fk W controller with Disk Extended Color BASIC 1 .0. 1 .1 , 2.0, or 2.1 ROM or 
i^ol/q j uuuo hum, to use R.S.B. v , 



Runs in /23K; 
5I2K 
preferred. 



R.S.B. $39.95 



Hard P/sfc Interfaces 

We've sold hundreds of our affordable, 
high-performance hard disk Interfaces to 
Color Computer enthusiasts worldwidel 
Each Includes an anodized housing, 100 page 
user manual, and software for use with OS9. 
The CoCo XT-RTC adds a battery-powered 
real time clock / calendar lor 0S9 and BASIC. j 

CoCo XT $69.95 
CoCo XT-RTC $99.95 



HYPER-I O is now compatible with DISTO , 
other SASIHard Disk Systems! 



QQQQ XT 



Answer a 
some common " 
FBCiS questions about 

the CoCo XT. 




®vit Utav of 



XT-ROM: In.lall XT-ROM In your hard 
dlok oonlrollar'e BIOS ROM 

;aily boots and rabooti 
OSS from your hard dlak. 

$19.95 




YPBH-I/O 

'Now BASIC runs hard drives? 
big floppies, and morel 



Burke & Burke has been offering our innovative line of Color 
Computer products to the public for one year now. Our 
customers often thank us for the fine service and support that we 
have given them. Now it's our turn to say, "THANK YOUI" 

What started out as a dream has become reality at Burke & 
Burke because of you and the hundreds of customers that have 
purchased our products in 1988. We thank you, above all. for 
the priceless recommendations and indorsements that many 
of you have given other CoCo users. 



HYPER-1/O modifies the RS-DOS BASIC in 
your CoCo 1, 2, or 3 to provide a "Dynamic 
Disk Interface". Use your existing BASIC and 
RS-DOS software with hard disk Interfaces 
(CoCo XT, DISTO, LR), RAM Disks, and any 
mix of floppy drives from 16QK to 720K each. 



Our sincere thanks, too, go out to the magazine 
SIG / BBS operators, club officers, and Color Computer 
dealers who have provided us with the means to 
promote, demonstrate, or support our products 
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P.O. Box 1283 Palatine, JL 60078-1283 (312) 397-2898 



Season's Greetings 




A true "NO HALT' hard disk system 
Controls 1 or 2 hard drives 
Full ECC and CRC error correction 
Average access 30% faster than SASI 
Uses PC-type hard disk controllers A drives 
Does not use or disable interrupts 
Compatible with moat RS-232 Interlaces 
20 Meg system cost: under $450 
Requires Multi PAK or "electric" Y-cable 

8uy a drlva, Wastsrn Digital oontrollar, and 
oaa* from tha PC daalar of your oholoa. 
Plug tham Into tha CoCo XT, plug tht 
CoCo XT Into your Mulll-PAK, and 
Install tha OSfl or BASIC 
sottwara. Praato! 
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Wild & MV Version 2.1 

Use "wildcards" with most OS9 
commands, or rearrange your directory 
tree. Features recursive directory 
' ' ' A hard disk must! $19.95 



EZGen Version 1.04 

Powerful OS9 bootfile editor. Change 
module names, add or delete 

modules, patch bytes, or 
rearrange modules. Works on, 
other files, too. $19.95, 



ILLINOIS RESIDENTS PLEASE ADD 7% SALES TAX. COO's 
add $2.20. Shipping (within the USA) $2.00 per CoCo XT; 
$1.50 per disk or ROM. Please allow 2 weeks for delivery 
(overnight delivery also available for in-siock Items). 
Telephone orders accepted (312) 397-2898. 




Multi-Vue Icon Editor 



Randy Krippner 



Multi-Vue is a fascinating program. It has 
drawbacks, of course, but it is still one of 
the most interesting programs to come along 
for the Coco 3. One of Multi-Vue 's features 
is that it permits a program to be run by 
simply clicking on an icon. 

When you do a directory of an 0S9 disk 
under Multi-Vue by clicking on one of the 
disk drive icons, Multi-Vue displays the 
files on the disk, together with an icon for 
each file. 

Normally these icons are the standard 
Multi-Vue default icons. But other icons can 
be created by the user for the purpose of 
identifying programs and making them into 
"point and click" executable programs. 

Making a program runnable from the Multi- 
Vue directory display by clicking on an icon 
is easy. You need two things; an icon and an 
Application Information File, or AIF. 

The AIF is a special file to Multi-Vue. 
When MV does a directory of a disk, it looks 
for files which are preceded by the char- 
acters "aif.". These files give Multi-Vue the 
information it needs in order to properly 
handle a particular program or data file. It 
contains information that tells Multi-Vue the 
name (pathlist) of the program or file, how 
much memory it requires, what type of window 
the program needs, how large the window must 
be, etc. It also contains the pathlist of the 
icon to be displayed. When Multi-Vue does a 
directory of a disk, it does not list the 
actual AIFs on the disk. Instead it displays 
the icon specified in the AIF above the name 
of the program listed in the AIF. It's all 
very simple, really. Unfortunately, Tandy and 
Microware complicated things by failing to 
provide a way to create new icons, 

There are icon editors available in the 
public domain on CompuServe, but not everyone 
has access to them. So IconEdit was born. 

IconEdit is a program that will let you 
draw your own icons for Multi-Vue. It will 
also create new AIFs to make programs into 
"auto-run" programs that can be executed 
under Multi-Vue by double clicking on an 
icon. IconEdit requires Multi-Vue (of 
course), the hi-res mouse interface, and 51 2K 
RAM. It MUST run on a 4 color, 320 X 192 
screen. If you try to use IE in the 16 color 
mode or in one of the 640 modes, I don't know 
what will happen, but the resulting icon will 
probably bear no resemblance to what you drew 
originally . 



So before you start to type in IE, you 
need an AIF to start up Basic09 on a 320 X 
192, 4 color screen. The following listing 
will do just that. It's an AIF which will 
display the Demo icon above BASIC09. When you 
double click on it, Basic09 will start in the 
correct graphics mode and with more than 
enough memory to use Icon Edit. 

Basic09 

icons/ icon. demo 

85 

8 

40 
24 
0 
2 

You can use BUILD or EDIT to create this 
AIF. Once you have IconEdit running, you can 
use it to make new AIFs without having to 
bother with a text editor. 

Save this as "aif.b94", for Basic09, 4 
color mode, or use some other name that will 
tell you what it is later. When you do a dir- 
ectory of this disk with Multi-Vue, just 
click twice on the Demo icon to start 
Basic09. (If you have more than one AIF using 
the Demo icon to start Basic09, you won't 
know which one is which, so put this one on a 
seperate disk or seperate directory. ) Of 
course before this will work Basic09 has to 
be either loaded into memory already or in 
your current execution directory. 

As was the case with Deluxe PowerGraph, 
you should have Basic09 merged with GFX2 , 
Syscall and Inkey. I described how to do this 
for DPG, so I won't repeat it here. 

IconEdit also requires that ERROR be in 
the execution directory or in memory, and 
that the ERRMSG file be in the SYS directory 
in order to handle the error trapping func- 
tions . 

If you have DPG you can save time by 
re-using some of the procedures from it for 
IE. One of Basic09's more powerful features 
is the ability to write independent pro- 
cedures which can be used in other programs. 

If you have DPG, load it into Basic09 and 
save the following individual procedures from 
it : 

ReadMouse 
QMouse 
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Du Arrow 

YesNo 

Oops 

WnSet 

GetFile 

Convert 

Delay 

After saving these, empty the Basic09 work 
space by typing: kill*. Then load these pro- 
cedures back into Basic09 and type in the 
rest of the procedures. Then save the whole 
thing to disk as IconEd.it. 

Using IconEdit is simple. After starting 
Basic09 in the 4 color, 320 X 192 graphics 
mode as described above, and loading Icon 
Edit, start it by typing "run main". The main 
screen will appear almost immediately. 

The large area occupying the ieft half of 
the screen is the icon editing area. To the 
upper right is a menu with four options: Save 
Icon, Make AIF, Clear Screen and End Program. 
Beneath this menu is a small box which will 
display the icon in actual size. 

The edit area shows the icon at a greatly 
enlarged size to make creating an icon 
easier. The edit area is made up of a box 24 
pixels high and 24 pixels wide. Each "pixel" 
in the edit area is actually an 8 X 8 pixel 
block . 

Drawing an icon is primitive but ef- 
fective. To set a pixel, just put the pointer 
at the correct location in the edit area and 
click Bl. To blank a pixel, put the pointer 
on the pixel, and click Bl again. Since an 
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icon is only 24 X 24 pixels, elaborate draw- 
ing functions are not necessary. 

As you draw your icon, the image will ap- 
pear at the same time, in actual size, in the 
small box to the right of the editing area so 
you can see what it will actually look like 
when Multi-Vue displays it. 

There are no seperate "modes" in IE. To 
select one of the functions on the menu, just 
point to it and click Bl . You may need to 
hold the button down for a second because 
response time on the menu is slow. The 
function being selected will be highlighted 
as you move the pointer over it. 

Save Icon will save your icon to disk when 
you're done drawing it. When prompted, type 
in the full pathlist for the icon. For ex- 
ample, if you wished to call your icon 
"phone", and wanted to store it in the ICON 
directory which, in turn, is in the CMDS dir- 
ectory, you would enter: 

/dO/cmds/icons/phone <enter> 

If a file by the same name already exists, 
you will be asked if it's alright to re-write 
it. Click on the YES box to go ahead and 
re-write it. Click on the NO box to abort the 
operaton . 

Make AIF will generate an Applications 
Information File for you. All you have to do 
is respond to the questions as indicated 
below : 

Program name: Enter the name of the 
program you want executed. For example, if 
you want this AIF to start up Basic09, you 
would respond by entering BASIC09 or the full 
pathlist of the program. 

Parameters: Some programs may require 
parameters to be entered when the program is 
started up. If this is necessary, enter these 
parameters here. 

Icon file: The pathlist of the icon to be 
displayed for this program. If you wished to 
use the phone icon used in the example above, 
you would enter: " /d0/cmds/ icons/phone " . 

Memory: The memory requirements of the 
program. Multi-Vue expects the amount of mem- 
ory to be given in "pages", each 256 bytes 
long. But dealing with "pages" of memory is a 
bit difficult for most people, so IE expects 
you to enter the memory requirements in 
bytes. IE will convert the number of bytes 
into pages for you. 

Screen type: The type of screen display 
required by the program. This is the "format 
code" of the required window as listed in the 
table on page 9-34 of the Basic09 reference 
manual that came with OS9 L2 . The screen type 
for the 320 X 192, 4 color mode, for example, 
would be 6 . 

Window width: The width of the window in 
characters . 

Window length: The height of the window in 
characters . 
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Background color: The color of the 
background . 

Foreground color: The color you wish the 
foreground (text) to be. 

The other menu functions are: 

Clear Screen: Will erase the screen and 
re-display the menu. 

End Program: Ends the program and returns 
to the Basic09 prompt. 

As usual, IconEdit can be obtained on the 
ClipDisk for this month if you don't want to 
type it in. 

Deluxe Power Graph Note: DPG will not work 
properly if PACKed. The drawing functions 
will work, but the disk I/O functions will 
not. The problem seems to be related to how 
0S9 allocates memory for PACKed Basie09 pro- 
grams. It appears that insufficient memory is 
being allocated to permit the graphics buf- 
fers to be mapped into the user address 
space. But since my schedule is pretty hectic 
at the moment, and since DPG works fine un- 
PACKed, I'm not going to look into the matter 
further at this point in time. If you come up 
with a solution, let me know and I'll print 
it in a future column. 



Questions and comments can be sent to me 

at : 

Randy Krippner 

1014 W. Hwy. 114, Lot 29 

Hilbert, WI . 

Note that the Unicorn BBS is temporarily out 
of service. When it comes back on-line, it 
will be with a new phone number. I'll publish 
it as soon as the board is operational again; 



Tandy 64K Color 
Computer II 

with Extended Color BASIC 

Only $49.95 

We just purchased 500 units directly 
from Radio Shack. These are new 
units, in original boxes with BASIC 
manual, switch box, and video cable. 

Ideal Christmas gift, backup computer, 
or upgrade from a CoCo 16K machine! 

Add $5.00 for S&H. We will only accept orders that 
can be shipped by UPS to the continental 48 states. 
Discounts are available on large orders. VISA/MC, 
checks, school purchase orders, no CODs. NY resi- 
dents add sales tax. 30 Day money back guarantee. 

Zebra Systems, Inc. 78-06 Jamaica Ave 
Woodhaven, NY 11421 (718) 296-2385 



More than a year has passed and 
now. . . 




It's Rush Caley & "Downtime!" 



Is Rush the "Morton Downey, Jr." of 
the CoCo World? Read his comments 
on Raja id. Fire Tog ics, Remedial.. 
Life, Quotable Quotes, and much 
more . 

Rush is back and with a vengeance. 
Alternating with Downtime will be 
a new Q&A column on business 
applications. Start 1989 with a new 
or renewed subscription to 
Clipboard and Downtime.. (Acid 
proof gloves not included) 



MJK Ik MJK3 
DOS ^ 

RAINBOW 

WHY BUY ADOS 3 "™ 
WHEN YOU CAN HAVE THIS 

Nn»: MJK-DOS for COCO 1. 2. n n d J $39.93 
Most poverfutl operative intern for the CoCo everl 
Allov-S up to 3 DS-ao track drives or itoniisrJ drive*. The 
DS-80 driTer are mftvtre configurable to standard Radio 
Shack* format in order to molntain compatibility. Allov* 
global file name specification vitb vildcordi. All the file* Till 
be displayed alphabetically, including the date that tho file 
▼ as saved Die one command to l ILL or COPT a, number of 
files that meet the global filename specification (can be a 
full diskl) in one run or one at a time upon user prompt 
(T-key) Use the powerful! CRAIN command to use programs of 
any length. Ore the built in f U LL SCREEN EDITOR to allOT 
fast and easy program modification Ton can even use the ISO* 
command that Till put you (after an error) in the modified 
line editor or get the automatic error trap routine -with 
fully spelled out error names. Hit one key to repeat the last 
command. You v i 11 also get error trap. repeat key. AUTO. 
DATE. CAT (tro columns of directory vitb. only the fllenamei 
A extensions). VAIT, RDNM. BAUD. FIND, OLD. tills, (string in 
basic program). J.C0 P T (groups of boric lines). REPL (to 
replace a string). TYPE (list o text file on screen/printer). 
SPLIT or JOIN basic lines. SAT for real spoken text, vord peek 
* poke and many more... MjE-DOS is primarily intended for 
double-sided B0-tr»ck drives (720t each) 

•ALLOTS TOO TO B E A D/ V R I T E / T 0 R M A T 35/40 DISCS OK A 80T DRIVE* 
■_*_ I _P_R_0 M AJ3LT ERE E_ J! IP D A T E S_ fOR 1 TEAR «**« 

Mjt:3i2 Dos<r.nco3-5i2r.) $49.95 

BUILT IH RAM DISC AND RAM TEST COMMANDS 

Monitor -Dirauerobler (COCO 1. 2 * . J ) $39.95 

Source-Code C.CDCrator/LabelGenerotor (C0C01.2A.3) $49.95 

Jfi REMOTE ri-Z32 pack driver for bb» etc. (C0C01.2.A3) $19.95 

HEVKET (COCOJ) oc v key scan -gives you true ALT * CTRL $15.00 

HE VHET 232(COC03)- -j B REMOTE and NEVtET in one package $25.00 

RTC -real time hardware clock for the coco 1.2 *3 $33.00 
CALL OH VR1TE (COD ORDERS OK) 

coco coMnectxon or vuxva. pa. 

5003 n ST 
VHTLA.. VA. 19120 
I-HOME' 215-457 11)09 POXCE AT1t> t)A7A 
COrLPUStULTl-E It)' 72317. 437(L£^l>£: PltON£») 
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Product Reviews 



Review Crew 



Dino Data Base 
RAM Electronics 
814 Josephine 
Monmouth, Oregon, 97361 

Pgm. Type: Educational 
Requires : 128K Coco 3, disk 
Price : $29.95 

.Dino Data Base is a unique and fascinating 
program. While it is a data base program in 
that it has the ability to retrieve and dis- 
play or print the information contained in 
the data base, that term is somewhat mis- 
leading. This program is more of an infor- 
mation retrieval system, since all of the 
information is already included with the pro- 
gram. The information contained in the data 
base is, of course, about dinosaurs. 

The program permits you to search for a 
particular type of dinosaur by simply typing 
in the name of the dinosaur, or the first few 
letters of the dinosaur's name. (As an alter- 
native, you can move forward or backward 
through the data sequentialy by selecting the 
NEXT or BACK options from a pull down menu.) 

After the dinosaur has been found, the 
main display screen will appear. This screen 
is split into four windows. The first shows 
the dinosaur's name, the pronunciation of the 
name, the name's Latin meaning, the Order and 
Family, the period of time in which it lived, 
and places where it was discovered. A second 
window displays a list of names of other 
dinosaurs that were related to the one 
selected. The third window displays a drawing 
of the dinosaur itself. The fourth window 
displays a world map, with indicators showing 
where the fossil remains of the dinosaur were 
found . 

After the dinosaur is displayed, the menu 
will pop up, permitting you to move backwards 
or forwards through the file to view infor- 
mation about other dinosaurs, perform another 
search, end the program, or jump into another 
mode which permits the information about a 
dinosaur to be printed out on a printer. 

The information about each dinosaur is 
limited, of course. It would be impossible to 
put everything known about these fascinating 
creatures into a single data file. But it is 
still quite interesting to flip through the 
data base, getting an idea of 
animals looked like, where they 
etc . 

This program is probably best 
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what these 
were found, 



suited for 



grade school aged children, who seem ab- 
solutely fascinated by it. They would flip 
through the various dinosaurs that appear in 
the data base and use the search functions to 
find particular dinosaurs they were inter- 
ested in. 

Dino Data Base is a very well crafted 
program. The only problem I had with it was a 
very minor one; there is no option to change 
the printer baud rate within the program. If 
you wish to use a baud rate other than the 
default of 600, you will have to poke 
appropriate value in before running 
program. 

The Memory Game 
RAM Electronics 
814 Josephine 
Monmouth, Oregon, 9 7 361 



the 
the 



Pgm. Type: Game 
Requires : 128K Coco 3 
Price : $19.95 



disk, joystick 



The Memory Game is a matching game similar 
to the old Concentration television show. 
Pairs of cards are placed at random, face 
down on the screen. The player uses the joy- 
stick to select two cards. These cards are 
turned over, displaying the symbol on the 
cards. If the symbols match the player gets 
credit for the match and may continue. If the 
cards do not match they are turned back over 
and the player has to try to make another 
match . 

Up to four people may play the game, 
taking turns at attempting to find matches. 
If more than one person plays, the winner is 
determined by who makes the most matches. If 
one person plays, the player works against a 
t imer . 

Operation of the program is simple. Except 
when entering in the names of the players, 
the game is operated entirely by the joy- 
stick. The author ought to be congratulated 
on the excellent use of the Coco 3's 16 color 
hi-res graphics. The display is colorful, 
attractive and very well designed. 

While the concept behind the game is 
simple enough so that even a pre-school age 
child can understand it and enjoy it, it is 
also challenging enough for adults. (My five 
year old son > beats me with embarrassing reg- 
ularity. ) 



0179 10 CREATE #path , ai f : WRITE 

0188 PRINT #path,pgm 

0192 PRINT #path,prms 

019C PRINT #path, icon 

01A6 PRINT #patb,mem 

01B0 PRINT #path, screen 

01BA PRINT #path,col 

01C4 PRINT # P ath,row 

01CE PRINT #path,bckgnd 

01D8 PRINT #path, frgnd 

01E2 CLOSE #path 
01E8 20 RUN gfx2( "owend" ) 

01F8 RUN gfx2( "curoff" ) 

0206 SHELL "tmode -echo" 

0215 END 
0217 100 enum=ERR 

0220 IF enum=218 THEN 

022C RUN yesnol "Re-Write?" , yes ) 

0242 IF yes THEN 

024B SHELL "del "+aif 

0257 GOTO 10 

025B ELSE 

025F GOTO 20 

0263 ENDIF 

0265 ENDIF 

0267 RUN oopsleniim) 

02 71 GOTO 2 0 
PROCEDURE Svlcon 

0000 TYPE regi.sters = cc,a,b,dp:ByTE; x , y , u : INTEGER 

0025 DIM regs : registers 

002E DIM enum, path: INTEGER 

0039 DIM yes: BOOLEAN 

00 4 0 DIM filename: STRING! 30 J 

001C RUN getfilef "Name" , filename) 

005D IF LEN( filename )<2 THEN 

006A END 

006C ENDIF 

OOfiE ON ERROR GOTO 100 
0074 10 CREATE #patb , f i lename : WRITE 

0083 RUN gfx2( "get" , 19, 1 , 248, 103,23,24 ) 

O0A0 regs.a=l \regs.b=$84 

0OB7 regs.x=$130t \regs.y=l 

. OOCE RUN syscall($8E,regs) 

00DC regs.a=path 

O0F.8 RUN syscall ( $8A , regs ) 

0OF6 regs.a=l \regs.b=S84 

010D regs.x=$1301 \regs.y=0 

0124 RUN syscall ($8E,regs) 

013 2 CLOSE #path 

0138 SHELL "attr "+f i lename+" e pe" 

014D RUN gfx2( "killbuff " , 19, 1 ) 

0163 END 

0165 100 enum=£RR 

016E IF enum=218 THEN 

01 7A RUN yesnof "Re-Write?" , yes) i 

0190 IF yes THEN \ 

0199 SHELL "del "+filename 

01A5 GOTO 10 

01A9 ELSE 

01 AD END 

01AF ENDIF 

01B1 ENDIF 

01B3 RUN oops(enum) 

01BD END 
PROCEDURE delay 

0000 DIM x : REAL 

0007 FOR x=l TO 70 

0019 NEXT x 

0024 END 
PROCEDURE kbuff 

0000 RUN gfx2( "killbuff " , 19, 1 ) 

, . . 

The Memory Game is an excellent 



alternative to the mindless shoot- ' em-ups 
that dominate the computer game market. The 
graphics are excellent, it's easy to play, 
but not easy to win. This is one of the few 
games on the market that the whole family 
will find entertaining. Highly recommended. 



FKEYS III 

Gimmesof t 

P.O Box 421 

Perry Hall, MD 21236 

Pgm. Type: Function key utility 
Requires : 64K Coco I/II/III, 1 drive 
Price : $19.95 

I do a lot of work with my Coco. I'm at 
the keyboard for at least four or five hours 
a day or more, so I am constantly looking for 
software to make life with a computer a 
little easier. FKEYS III has proven itself to 
be one of the best function key utilities 
I've seen. 

The basic idea behind function keys is 
this: Instead of having to type in a long 
string of characters to make the computer 
perform a task, function keys let you do the 
same task by simply pressing one or two keys 
instead of ten or twenty. Instead of typing 
something like "CLS : DIR0 : ?FREE( 0 ) <ENTER>" 
all I have to do with FKEYS III loaded is 
press Fl on my Coco 3 keyboard. 

FKEYS III comes with twenty predefined 
functions that can be activated by simply 
holding down the CTRL key, then pressing the 
function key, (The down arrow key is used as 
a control key on keyboards that lack the 
extra keys of the Coco 3 keyboard.) 

Any of these functions can be easily 
redefined to fit your own needs. Just about 
any RS-DOS or Extended Color BASIC command 
can be programmed into a function key. The 
only restriction is that the function can 
only be up to 25 characters in length, which 
should be sufficient for almost any appli- 
cation . 

FKEYS III can make life much, much easier. 
You can load and run programs, call up disk 
directories, do POKEs or perform any function 
you would normally type in, just by pressing 
a function key. 

And, of course, FKEYS III lets you save 
your redefined function keys to disk so you 
don't have tp reprogram them every time you 
want to use the utility. 

If this was all FKEYS III did, it would 
still be a very useful program. But there's 
much more. 

FKEYS III lets you modify your DOS to 
handle 35 or 40 track disk drives, single or 
double sided drives, and can even change the 
step rates to increase the speed of the 
drive. It also resets the drive head to track 
0 to prevent the annoying head banging prob- 
lem that occasionally occurs if the drive 
head is in the wrong place when the drive is 
turned on. 

There is even an option to save the 
modified DOS to a disk file which can then be 
used to burn an EPROM which can be used to 
replace the DOS ROM chip in your disk drive 
controller so that the FKEYS III functions 
you've defined can be available as soon as 
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Master Basic09 



Bill Brady 



I just got home from the RainbowFest in 
Princeton where Ted reminded me that I am due 
for another column. Time sure flies! 

Many of you that read this column know 
that I have been working on a program called 
Wiz Professional. Well, I did release it at 
the 'Fest as promised, but not as a com- 
mercial product. I decided to go shareware 
instead. The package is already available on 
all of the services and many BBS's. If you 
cannot download it for whatever reason, I 
will put the same package on a disk that you 
send me & return that disk to you. If you 
wish the entire package, see the shareware 
notice below. 

********************************************* 

Wiz Professional Sharware Information 

copyrighted 1988 by 



Wiz Professional 
William L. Brady. 



OS-9 owners who wish to support the 
development of Wiz Pro and extensions are 
asked to make donations to: William L. Brady, 
1503-1 Flanders Lane, Harwood MD 20776. Do- 
nations received in excess of $39.95* will 
receive the 50+ page laser printed manual, 
which includes margin notes and many illus- 
trations, plus the unabridged version disks 
which include WizClipper and WizAuto XPROCS , 
and other extensions/updates, autolog file 
examples and source codes. 

To become fully registered as a Wiz Pro 
user, include the following information: 
First name, > Last name, street #, street name, 
city, state/province, code, country, CIS PIN, 
Delphi and Genie address. 

*Wiz users making a donation in excess of 
$19.99 will receive the same package on re- 
ceipt of a COPY of the WIZ coupon, plus a 
copy of their sales receipt. See the Wiz 
manual, do NOT send to FHL. 

Those wishing to become Wiz Pro developers 
will receive additional resources and direct 
support. A donation of $25.00 is requested to 
cover the extra expenses. 

Please to not send electronic mail to the 
author on CIS. Mail is OK on Delphi, 
(OS9UGED), or GEnie, (B.BRADY), or in the CIS 
OS-9 forum message base. (Bill Brady 70126, 
267). 

Should I use this program? 
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Wiz Pro is a very powerful program. It 
gets its power from Basic09 and OS-9 Level 2. 
To do this, it must be fully integrated into 
the system. There are two reasons why this is 
important to you. First, you will have to 
make a new boot. Tandy & Microware do not 
allow third party s/w writers to provide 
bootable OS-9 software for the Color Com- 
puter. Making a new boot can be tough, but 
once you master it, you are in control of 
your own computer. You are the "system man- 
ager." The second factor is that you may need 
to "clean-up" your system. If you have in- 
stalled patches to system modules, you may 
find that they interfere with the interrupts 
that are vital for the RS-232 pak to func- 
tion. You will need to remove them. 

********************************************* 

All of the above assumes that you already 
know about Wiz Pro, but in case you have 
never heard about it, it is a terminal pro- 
gram that many consider among the best for 
any computer. 

Someone recently referred to me as a third 
rate programmer. The truth is that I am not a 
programmer at all. In that regard I am at 
least 4th or 5th rate (grin). But having been 
a hardware type back when hardware was 
expensive and software was cheap, I learned a 
few important things. Foremost is that I 
learned how to find "boundaries." 

The first of these boundaries is the one 
between the hardware and the software. To 
explain why this is so important, I need to 
use an example, which I will do a little 
later. First a short course in systems en- 
gineering . 

This may seem simple, but the first step 
in deciding on exactly what you want to do 
with the computer. For example, you want to 
write a letter. You begin to build a list of 
requirements. One way is to ask questions 
like: Does the letter have to be stored in 
the computer? Is hardcopy required? How big 
is the letter? Is the letter to contain text 
only, or text and pictures? Is it necessary 
to edit the letter? 

From this list you can select items and 
allocate them to resources that are avail- 
able. Storing the letter might be allocated 
to a disk drive, printing to a printer etc. 
As you go along, other requirements build: a 
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Modular Programming 



Boisy Pitre 



Greetings again! I trust you have been 
practicing some modular design techniques in 
your work, Things have been rolling and chug- 
a-lugging here in Brookhaven, Mississippi. As 
I write this, Hurricane Gilbert, as most of 
you have heard about, may be planning a visit 
to our gulf coast in a day or two. Actually, 
I have been relatively busy squeezing in Disk 
BASIC programming time between college alge- 
bra, trigonometry, and OS-9 Level II, Don't 
worry fellow Disk BASIC comrades, I haven't 
been completely converted to OS-9. I'm just 
dabbling into the fundamentals,- but that's 
another story. 

Last issue we went over modular design 
programming, and some of the events that 
occur when we neglect to use it. After mas- 
tering the BASIC language, we have a tendency 
to neglect those important aspects of pro- 
gramming we so precariously noted when we 
first learned BASIC . 

Looking back on my first experiences with 
the CoCo , I can see how my attitude towards 
preciseness had diminished. Most of the time 
I had spent planning a simple program was 
neglected when the biggies came. That's the 
time I really should have been attentive! 
After viewing and studying listings from 
other languages like C and BASIC09, I real- 
ized that there was a better way. With eager- 
ness, I purchased a book on structured 
programming for the IBM. Since GW-BASIC and 
CoCo BASIC are basically (no pun intended) 
the same, there were few conflicts with pro- 
gram listings and no conflicts with modular 
concept . 

After studying the book, I realized that 
complex BASIC programs COULD be done in a 
truly structured manner. The most dreadful 
times I faced was when my ideas failed to 
come about because of complexity in struc- 
ture. Instead, the confusion of keeping up 
with variables, GOSUBs, and GOTOs were just 
too burdensome. Modular programming showed me 
a better way. And it can help you too. 
Programming takes as much concentration as it 
does skill. One can be fluent in BASIC as 
comparable to an American to English, but 
enough ?SN ERRORs and ?FC ERRORS can bring 
frustration to the programmer. Although some 
make it through, most reach behind the CoCo 
for the power-switch and push it in, putting 
the idea out of their head. 

This is where modular design steps in. 
Some of you may have played out the same sce- 



nario as the one above. However, programming 
doesn't have to be a sweat-it-out, mind- 
boggling experience. 

In this issue we will be concentrating on 
the last two program modules: SUBROUTINES and 
ERROR TRAPPING. I'll also be giving a few 
hints and then finally sum up modular 
programming and announce the "winning idea." 
For those of you who are just arriving on the 
scene, I suggest that you order back issue #7 
for the beginning article on modular pro- 
gramming . 

Ok! Load the MODTUTOR program you typed in 
last issue. Verify that it is in memory with 
a LIST or RUN, then type in Listing 1. Don't 
worry about it conflicting with your program 
in memory -- the line numbers will neatly fit 
in place, that is if you haven't RENUMbered 
your listing from last month. After you have 
typed and debugged, SAVE your program under 
the same name ( MODTUTOR . BAS ) . You now have 
the complete Modular Design Tutor program 
available along with a fix for a bug found in 
the listing last issue. Bear in mind that the 
purpose for this program was not just to give 
you something to type. Use it as an outline 
for your future modular programming projects. 



THE ERROR TRAP MODULE 



LINES 40000-49999 



This module is debatable. Since the advent 
of the CoCo 3, error trapping has become a 
luxury. On the older CoCo 1 and the CoCo 2 
however, error trapping is considerably 
harder to implement and manage. I'll go over 
both the CoCo and the CoCo 3 techniques of 
error handling, 

CoCo 3 programmers have the luxury of ON 
ERR GOTO. Somewhere in your MAIN PROGRAM 
module, set up the line specified by the ON 
ERR GOTO command in the INITIALIZATION 
module, which follows this format: EL=ERLIN: 
ER=ERRNO : GOTO 40000. This way, EL holds the 
error line and ER holds the error number. Use 
every two lines, like 40000-40001, 40002- 
40003, to check the error number and take the 
needed action, proceeding each with a GOTO 
EL, or whatever line number you wish. It is 
also a good idea to comment on each error 
condition and action with a REMARK. 

CoCo 2 programmers don't have it as easy. 
There are some commercial programs which give 
CoCo 1 & 2 users an ON ERR GOTO command, but 
programs of that nature are not owned by all. 
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VIDEO ENTERTAINMENT 



the computer is turned on. (It's up to you to 
burn the EPROM yourself or find someone to do 
it for you . ) 

FKEYS III is a very useful utility, and 
one which I have enjoyed using a great deal. 



a few tips for those of 
type of error handling 



I do, however, havi 
you who have no 
management at all. 

One error we will play is the ?NE ERROR, 
or Non-Existent file. This error occurs 
mostly when, let's say for instance, one 
program calls another program or data file on 
the^disk. Use this short program to take care 
of this error: 

1000 OPEN"D" ,#1 , "SOMEFILE.DAT" 

1001 IF EOF(1)=0 THEN PRINT " FILE DOESN'T 
EXIST! " : END 

1002 CLOSE #1 'Continue from here... 



DilJO PEC1UKE LATA BASE- iy4 Dinosaurs 1 Names, areas, 
latin meanings, time periods, pull down menu, world map 
on screen. Powerful, colorful educational .0X03 19.95 






Build your own coin-operated Video Game using the COCO! 
Complete instruction book with plans, schematics, parts 
sources. All software provided and includes a 4 in 1 
^video game Uiflt you can use. COCO 1 and 2. Disk 19.95 


Autoboot your computer- This hardware project will 
RUN a program as soon as tte COCO is turned on, 
without you having to touch the keyboard! Schematics 
and instructions only 9.95 COC01 and 2. will work 
on most switch matrix type computers. 




jfc9p^) HUSH 


r -* 

fraze CRAZE- Wheel a fortune with this popular word 5 
game. COCO 1,2 64K or COC03. 9.95 DISK ^ 


TilE MEMORY GAME-FHp a card and see if you can f-urf its match. With basic 
shapes for younger players, all the way up to intricate shapes for those 
with CQNCENTRAT ING minds. A beautiful family gamel C0C0J, Joystick, Disk 9.95 


Why go to RENO? Now you can enjoy tlie excitement of a Casino style 
game with BIG CI TV KENOi Be a big winner on the COC03, Disk, 9.95 


CHECK, MONEY ORDER OR C.O.D. IN U.S. FUWDS TO RAM ELEC1WONICS 
814 JOSEPHINE, MONMOUTH, OREGON PHCtlE NUMBER 5Q3-833-0139 




Your Pgraqnal Electronic Photo Albu» 



Put you, your spouse, your kids, your Grandma, your 
dog, or anything els* you like on your very own 
personal picture disk! You send us your pictures or 
artwork and we will digitize It and save It on disk 
for you, in one of the foraats below. Originals can 
be as small as a stamp or as large as a poster. All 
originals returned. 

The cost la H13.95 for the first disk and S10.00 for 
each additional disk, ordered at the saae time. Each 
disk can contain ONE of the following: 

8 MGE format files < f or Colorma*3> or 
10 CM3 foraat files (for CoCoMax3) or 
13 PMODE foraat flies (for CoCoMaxII, MCPAIHT, etc.) 

Pictures should be fairly high contrast or the results 
can be disappointing. Be SPECIFIC about the roughly 
square area you want digitized. 

Those ordering MGE or CM3 foraat pictures for their 
CoCo3 will also receive the Incredible viewer program, 
VUHASTER. absolutely FREE I CoCol,2 or 3 owners can 
cut out or copy this ad, send It in with your order 
and get the »10 PMODE viewer/aanlpulator, GrafFlnd for 
only *5! (Reviewed In Apr '88 flainbow and Jul/Aug '88 
CoCo CI tpboard> 

For a FREE saaple disk, please send «3.00 S/H, along 
with your aodel CoCo and the format you wish. Call or 
write if you have questions or need additional 
details. 



Add S3 S/H per order. 
Payment may be personal 
check or Money Order 
only. Sorry, no cash, 
credit carda or COD' a. 



10625 SE 362nd B32 
Boring, OR 97009 

(5031663-2423 (9a«-3pm PST) 



The routine above opened a file called 
SOME FILE . DAT . Since this was a random access 
file, it wouldn't have given an ?NE ERROR if 
the file didn't exist. Instead, it went ahead 
and created the file, though empty, and 
checked to see the EOF flag. If EOF was 0, we 
automatically knew that the file was empty, 
therefore never existing in the first place. 
Of course, you would need to KILL the empty 
SOMEFILE.DAT file because it was created by 
OPEN"D" . 

?SN ERROR is an error that should be 
encountered with only when developing and 
testing the program, not at user RUN-time. 
With experimentation, try finding other ways 
to circumvent errors. For instance, to pre- 
vent a ?DF ERROR (Disk Full), use the 
D=FREE ( 0 ) function. If D=68 or the number of 
tptal granules that your disk can hold, then 
print a DISK FULL message. 

THE SUBROUTINE MODULE — LINES 50000-59999 

The SUBROUTINE module contains subroutines 
for the program. Commonly used routines, such 
as PRESS A KEY prompts and INPUT commands can 
be inserted here. I've always believed that 
it was better to use GOSUBs instead of the 
same commands over and over again. The SUB 
ROUTINE module benefits the programmer by 
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conserving memory that would otherwise be 
used by repetitive commands. It also cuts 
down considerably on typing. 

The SUBROUTINE module should be broken 
down into separate subroutine fields seper- 
ated by REM statements. Each REM statement 
should fully comment the subroutine. I re- 
commend keeping a subroutine library in ASCII 
format with a line number range of 50000- 
59999. When you need your library, just MERGE 
it to the program you are working on. Presto! 
Instant magic! 

SUMMING IT UP 

Modular programming is advantageous. It's 
design and concept is easy to grasp and well 
organized. Maybe there are some of those who 
are set in their ways about their own style, 
but for beginning programmers and those want- 
ing to get into serious Disk BASIC pro- 
gramming, it will save you many wasteful 
hours. Keep in mind the basic module 
structure of top-down design. Feel free to 
experiment with your own preferences. Be 
innovative! You may be able to program better 
with another style that the one we have been 
practicing with. All in all, implement, 
implement, implement! Use it every chance you 
get! Learn it to the bone and without a 
doubt, you will see your ideas come to life! 



1040 PRINT : PRINT" THE INITIALIZ 
AT 1 ON MODULE IS MAKES UP THE FI 
RST 10U LINES OF YOUR PROGRAM. 
IT IS THE SET-UP PART OF YOUR PR 
OGRAM. COMMANDS SUCH AS pclear, 

clear, AND dim SHOULD BE USED 
HERE. M : PRINT 

104 1 PRINT " YOU MAY ALSO DEFI 
NE NUMERIC AND STRING DATA HERE 
USE YOUR 5 ONLY-ONCE ' COMMANDS 
HERE. " 

1999 GOSUB4 000 1 : GOTO 250 

2999 GOSUB40001 :GOTO 250 

3000 '*** CHOICE 3 *** ' 
3010 CLS 

3020 PRINT" PART THREE-ERROR T 
RAPPING 
3030 PRINT' 
49999" 
304 0 PRINT 
3050 PRINT' 
MODULE IS 
CTOR. ON 



LINE RANGE: 40000- 



1 THE ERROR TRAPPING 
USED AS AN ERROR DIRE 
THE COCO 3 WITH THE O 
N ERR GOTO COMMAND, YOU CAN USE 
ERRNO & ERLIN WITH CONDITIONA 
L OPERATORSTO TAKE CARE OF ERROR 
S EASILY. " : PRINT 

3060 PRINT" COCO 2 OWNERS SHOUL 
D CONSIDER PURCHASING ERROR HAND 
LING UTILITIES OR OTHER AL 

TERN AT IVES . " 



3070 GOSUB40001 : GOTO 250 

3999 GOSUB40001 : GOTO 250 

4000 '*** CHOICE 4 ***' 
4010 CLS 

4020 PRINT" 



TINES 

4030 PRINT" 

59999" 

404 0 PRINT 

4050 PRINT" 

LE HOLDS 

D CODE & 

OGRAM . 

OMMENT 

NT 

4060 PRINT 
E YOURSELF 
WITH YOUR 
UBROUTINES. 
D MERGE IT 
RE WORKING 



PART FOUR-SUBROU 



LINE RANGE : 50000- 



THE SUBROUTINE MODU 
THE MOST COMMONLY USE 
STATEMENTS IN YOUR PR 
FOR EASY REFERENCE, C 
EACH SUBROUTINE . " : PRI 



BETTER YET, COMPIL 
A SUBROUTINE LIBRARY 
MOST COMMONLY USED S 
SAVE IT IN ASCII , AN 
TO THE PROGRAM YOU A 
ON . " 

4070 GOSUB40001 : GOTO 250 
4999 GOSUB40001 : GOTO 250 
5999 GOSUB40001 : GOTO 250 

40000 '***** SUBROUTINES ****** 

40001 ' PRESS A KEY PROMPT 

40002 PRINT@490, "PRESS A KEY:";: 
EXEC34442: RETURN 



VIP Calc 

"MORE USEABLE FEATURES" 
FEBRUARY 1985 "RAINBOW" 

Now every CoCo owner has access to a calculating and planning 
too! better than VisiCalc™, containing ail its features and 
commands and then some. VIP Calc displays 32, 51, 64 or 85 
characters by 21 or 24 lines right on the screen. VIP Calc allows up 
to a 33K worksheet with up to 512 columns by 1024 rows! In 
addition, VIP calc has multiple windows which allow you 10 
compare and contrast results of changes. Other features indude 
16 DIGIT PRECISION • trig, functions • averaging • algebraic 
functions • column and row ascending or descending SORTS • 
locate formulas or titles in cells • block move and replicate • global 
or local column width • limitless programmable functions • works 
with any printer, Embed printer control codes for customized 
printing. Combine spreadsheet tables with VIP Writer documents to 
create ledgers, projections, statistical and financial budgets and 
reports. Requires 64K. DISK $59.95 



VIP Speller 1.1 

INCLUDES 50,000 WORD DICTIONARY 

VIP Speller works with ANY ASCII file created by 
most popular word processors - even Telewriter 64. 
It automatically checks text files for words to be 
corrected, marked for special attention or even 
added to the 50,000 word Dictionary. You can even 
view the word in context. Words can be added to or 
deleted from the dictionary or you can create your 
own dictionary! New features of version 1.1 are 
FASTER and more RELIABLE disk access and 
printing at 9600 BAUD. DISK $34.95 



VIP Speller owners: upgrade to VIP Speller 1.1 for $5 irSSp 
+ $3 S/H. Send only ORIGINAL disk and $8 Total. 
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t "EZWRI1ER" does professional-quality letters j 

! quickly and easily. "EZWRITbR" will automa- j 

! tically set the margins & characters per line, j 

\ indent paragraphs, put your heading/greeting/ < 

J closing in the right places, and even center the I 

\ letter on the page! Just type your message and I 

J watch your DWP or EMP print a perfect letter ! ! ! t 

J Handles 1-4 page letters, mailing lists, and i 

j labels- It will make it possible for you to \ 

j send any number of copies with a salutation for | 

j each recipient!! Perfect for personal corre- j 

j spondence, for letters to club members, or for j 

l direct mail advertising. "EZWKITER" is by far | 

( our //I Best Seller, and it's no wonder; it's the j 

< absolutely simplest letter writing system avail- j 

' able for the CoCo! Still only $19.95 plus $1.50 \ 

! S/H for either disk or cassette. GREAT on the j 

! CoCo 3 but will run on any CoCo with 32k ECB. j 

■MM E.Z. FRIENDLY SOFTWARE MMMHM \ 

g HflCORLIES AVE. • POUGHKEEPSIE. NY 12601 • (914) 4B5 6ISG f 
Jj (Add SI. 50 s/h to all orders. NY residents add state sale;, tax ) I 

capability of opening, reading, modifying 
disk files is needed, so we allocate that to 
the software. When you store files on a disk, 
they must be named... you allocate that to 
the operator (perhaps). The files should also 
be organized in some way so they are easy to 
find., you allocate that to ... software? the 
operator? the operating system?? Beginning to 
get the idea? 

Now for the importance of this process of 
allocation. Back in the 70* s computer 
hardware was not as smart as it is today. The 
math capabilities were often limited to add, 
shift, AND, OR, and complement. You sub- 
tracted by doing a complement, then an add. 
Multiply was done by shifting. About this 
time I worked a project where there was a 
real need for the capability for high pre- 
cision (floating point) math. The capability 
did not exist. Since the person in charge was 
a programmer, this requirement was allocated 
to s/w. A number of programmers started work. 

A great deal of time and money were used 
in this effort. A deadline loomed. The 
floating point software package still did not 
work, it was very slow, it used up a great 
deal of hardware resources. Perhaps another 
computer would be required. Enter the 
hardware types. 

We found a black box called a floating 
point processor. It cost $5000, less than 
l/50th of what had already been spent on the 
s/w effort. It was lightning fast, and used 
almost none of the main processors time since 
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it ran in parallel. It had one other advan- 
tage: it worked. 

So you can see that finding that hardware 
/ software boundary was very important. If it 
had been done sooner it would have saved many 
dollars, later would have meant the failure 
of the project. 

These boundaries exist, and must be 
identified at many levels. There are bound- 
aries between h/w and s/w, between h/w and 
operations, between s/w and operations, and 
between s/w and s/w. Software boundaries in- 
clude those between the operating system and 
the application, between an application and a 
device driver and between the operating sys- 
tem and a device driver. 

Boundaries shift. What causes these 
shifts? Time, money, the operator, and the 
building of the resource pool in both s/w and 
h/w. In what directions do we want the shifts 
to go? Less time, both to develope, and to 
use, and less money of course. But the never 
varying final goal .is to shift the boundary 
AWAY FROM OPERATIONS! 

How does all of this apply to Basic09? Re- 
member that my goal in this column is not 
just to tell you how to do something , any 
programmer can do that, but to tell you the 
why and when. Why use Syscall? When? Why use 
Basic09? When? Let us begin to take a look at 
the boundary between a piece of hardware, a 
modem, and a piece of software, a terminal 
program . 



FILE TRANSFER UTILITIES 

You asked for K at the Chicago RainbowFesi - 

FILE TRANSFER UTILITIES MOW HANDLE RSDOS DISKS! 

Need to transfer text ties to and from PC (MS DOS), RSDOS and FLEX disks into 
your CoCo (OS-9) Bystem? Have text fies on a PC (MSDOS ) system at work and 
wart to work on them ai home on your CoCo? 

With GCS File Transfer Utilities you just oface the PC (MSDOS). RSDOS or FLEX 
disk into your CoCo d*k drive - enter a simple command and the file is copied tnto 
a CoCo OS-9 file. Re transfer back to PC {MSDOS), RSDOS and FLEX disks is 
just as simple. 

PCDW directory of PC disk RSOtfl directory of RSDOS disk 

PCOUMP display PC disk sector RSDUMP display RSDOS disk sector 
PCREAD read PC file RSREAD read file from RSDOS disk 

PCWRfTE wrte file to PC disk RSWRfTE write file to RSDOS ttek 

PCRENAME rename PC file FLEXOIfl directory of FLEX disk 

PCDELETE delete PC lite FLEXDUMP display FLEX disk sector 

PCFORMAT format PC disk FLEXREAD read FLEX file 

FLEX WRITE write file to FLEX disk 



Extensive Single, double sided disks. 40 or 80 track floppy drives. 
Options 8 or 9 sectors. First level sub-directories - PC ( MSDOS). 

FLEX transfers binary fiies also. 

Requires OS-9 (Level 2 for MultiVue), 2 drives (one can be hard), MultiVue 
lor MutiiVue version. SD1SK (SDISK3 for MultiVue) - sea D.P. 
Johnson ad for SDISK 

GSC File Transfer Utilities for CoCo - MultiVue version $54.95 

GSC File Transfer Utilities for CoCo - Standard version $44.95 



are CoCo OS-9 format. Orders must be prepaid or COD. VISArMC 
, add $1 .50 S&H, additional charge lor COD. 



GRANITE COMPUTER SYSTEMS 

Route 2 Box 445 Hilteboro, N.H. 03244 RAINBOW 
(603)464-3850 cesiificaiion 



Data comes out of a modem serially, that 
is one bit at a time. The computer stores 
data in parallel, 8 bits per word. If we are 
to move data out of the modem and into the 
computer, a serial to parallel conversion 
must take place. In the Color Computer we 
have a harware device called a PIA. Without 
going into great detail I will just say that 
the PIA can be made to read one bit at a 
time. With software we can convert 8 bits to 
one word, but it is not that simple. You must 
know which 8 bits to put into any particular 
word - it's called synchronization. All of 
this can be done. Many fine terminal programs 
exist which do this technique called "bit 
banging." The problem is that this process 
takes every bit of the hardware's resources, 
just to work at relatively low baud rates. 
The bottom line is that you cannot do any- 
thing else while the conversion is going on 
and even then it is slow at it's max speed. 

Remember the floating point hardware? Well 
there is "serial-to-parallel" hardware also. 
One of these devices is called an Asyn- 
chronous Communications Interface Adapter or 
ACIA for short. Just like the floating point 
h/w, the ACIA is much faster, and takes no 
resources and does both the serial to par- 
allel conversion and the synchronization. 
Unfortunatley , Tandy did not build an ACIA 
into the Color Computer. 

So, if we are writing a terminal program 
for the CoCo, we must decide whether to allo- 
cate the s/p conversion and synchronization 
capabilities to h/w (an RS-232 Pak) or to the 
s/w (a "bit banger".) Not all users own an 
RS-232 pak. 

Under OS-9 our decision is a little 
easier. OS-9 is mul it-tasking and on the CoCo 
we have windows. These two capabilities of 
the operating system allow us to clear-key to 
another window and run some other program at 
the same time as our terminal program. Those 
of you who use this capability know that this 
is no trivial nicety, but is what makes the 
CoCo such a powerful computer today. Why 
throw this away? Why not xmodem a file in one 
window and de-archive it on the fly in 
another? 

To use the bit-banger port would negate 
all of this. So we allocate the capability to 
h/w and require an RS-232 pak. This still 
doesn't solve the problem however, and we can 
still blow our mul ti- tasking capability even 
with an RS-232 pak. How? By placing yet other 
boundary in the wrong place! Next time we 
will see just how fine this line must be cut, 
and look at some code. 

Before leaving you, however, I promised to 
show you how to capture a mouse "key down" 
event within a Basic09 procedure. With Wiz 
Pro, any time you are on line you can pause 
both Wiz and the host by simply tapping the 
mouse key. This allows you to stop some- 
thing from scrolling off of your screen 
before you've had a chance to read it. For 
this to happen, and to really be useful, 
everything must come to a halt very quickly. 
I choose to use the SS.MsSig system call. 

The SS.MsSig call tells OS-9 to send you a 
signal when the mouse button is pressed. Th^ 



call also allows you to specify a signal # 
for the call to return. See page 8-141 in the 
Level 2 manual. 

First lets set the signal: 

(* ********************** 
s.a=0\ s.b=$8A\ s.x=140 
RUN syscall(ststat ,s) 
(* ********************** 

Now something to "catch" the signal: 

(* ********************** 

ON ERROR GOTO 100 

(* ********************** 

Now something to process the signal: 

(* ********************** 

100 en=ERR 

IF en=141 then 

(* send x-off, go to sleep etc 
f* ********************** 

When we are we don't want to leave the signal 
active so we disable: 

(* ********************** 
s.a=0\ s.b=$lB \ s.x=140 

RUN syscall(ststat,s) 

(* ********************** 

See you the next time! -Bill Brady 



VIP Terminal 

RATED BEST IN JANUARY 
1984 "RAINBOW" 

For your important communications needs 
you've got to go beyond software that only 
lets you chat. You need a smart terminal 
so that you can send and receive 
programs and messages and print them! 
The VIP Terminal features 32, 51 , 64 or 85 
characters by 21 or 24 lines on the screen 
and has a 43 K byte buffer to store 
information. DISK $29.95 



VIP Disk-ZAP 1.1 

RAVED ABOUT IN THE 
APRIL 1983 "RAINBOW" 

Now you can retrieve lost data on any disk. VIP 
Disk-Zap is the ultimate repair utility for repair of 
most disk errors. VIP Disk-Zap verifies diskettes, 
reads and writes any sector and lets you retrieve ail 
types of bashed text files, BASIC and ML programs. 
VIP Disk-Zap includes an informative 50 page tutorial 
manual. New features of version 1.1 are FASTER 
and more RELIABLE disk access and printing at up 
to 9600 BAUD. DISK $24.95 



VIP Disk-Zap owners: upgrade to VIP Disk-Zap 1.1 for m<s=> 
$5 + $3 S/H. Send only ORIGINAL disk and $8 Total. 
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CoCo and The Model 100 



Rush Caley 



I was dumbfounded when Ted asked me to do 
an article about this subject. I've been rel- 
atively well known in the GoCo market for a 
number of years - at least in the business 
applications portion of it. But one thing not 
many people know about me is my passion for 
the Model 100 laptop computer. It is not as 
though I have to keep it sequestered away 
somewhere so no one will notice it; but I 
don't talk about it too much. There's a cer- 
tain "cloak of loyalty" that has to be worn 
and recognized when facing CoCo fanatics. 
It's funny, I use my Model 100 almost as much 
as I do the CoCo. And for all these years, I 
still feel like a philandering husband 
cheating on his faithful wife. 

Anyone who has used a laptop for any 
length of time will realize that how you sup- 
port the laptop is wholly defined by your 
specific "workstyle" and the particular tasks 
you need to accomplish. The purpose of this 
article is to mention some of the more useful 
things that one can do by interfacing the 
Model 100 with our beloved CoCo. 

When it was originally released, the M-100 
arrived "out of the box" with 24K RAM and 
sported an 80C85 8 bit microprocessor that 
ran at 2.4 MHZ . The LCD screen was 40 X 8 
lines. It also came loaded with ROM software 
or "built-in" applications programs. It had 
BASIC (one better than the CoCo's); TELCOM, 
telecommunications capabilities at home or 
from any phone booth; a TEXT processor, 
albeit limited; and two other applications 
whose primary uses were maintaining addresses 
and scheduling appointments and th ings- to-do . 
It also had parallel printer port, RS-232, a 
Bar Code reader, a terrific keyboard, and 
much more. But the best thing about this 
highly tauted Tandy toy, was that it fit into 
any standard briefcase and you could compute 
anyplace you happen to be. The price was: 
$999.95. 

Originally, the M-100 was designed to 
store its data on tape cassette. You long 
time CoCo users know what that is like. So 
the very first obstacle to overcome was stor- 
age capacity and more speed. Early on, Tandy 
offered its Disk Video Interface, but it cost 
$800! Also, it was clumsy to hook up and un- 
hook the darn thing. Furthermore most people 
bought the M-100 for its portability, and the 
DV/I seemed to run contrary to intent. Then a 
company in Dallas came up with a unique con- 
cept. They called the program DISK+. It 
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required a null modem cable and had 2 func- 
tions. First, it would allow you to hook up 
to your CoCo via the serial po^c, and store 
programs and files on your CoCo's drives. 
Also, it could unload or load them at 9600 
baud! Additionally, it had a file transfer 
program so that you could convert the files 
back and forth from Model 100 format or CoCo 
format. For example, if I were on the road, 
and picked up a nifty program off the CoCo 
S.IG on Compuserve, J could down load it to my 
M-100 and then upload it to the CoCo when I 
returned home. So this was my first use for 
interfacing the CoCo with my portable: stor- 
age space, and speed of file saving and 
loading . 

This interface ability became a real boon 
in the near future. I had moved from Seattle 
to my current residence in Fort Orchard and 
had to commute back and forth on the ferry 
boat every day. Fortunately, I was able to 
use the commute time productively. I could 
type away on my portable and then transfer 
files to the CoCo when I arrived at work. I 
kept my time management and scheduling pro- 
gram on the model 100 so I always had the 
information at hand. The files could be 
stored on the CoCo at work and on my M-100' s 
"Chipmunk" disk drive at home. I don't think 
I could count the number of documents 
polished up on Telewriter 64tm that had 
originated on my M-100. The Spreadsheet I 
used is called LUCIDtm. It is a very sophis- 
ticated program with capabilities I did not 
have on the CoCo. I could store spreadsheet 
files on the CoCo disk. Also, I could spool 
the formatted output to an ASCII RAM file and 
read it into Telewriter at work. These and 
other applications like them, made my com- 
muting days much more tolerable. 

THE PRESENT 

The "CoCo/Pico" romance was now in full 
bloom and has continued ever since. In my 
present job at Boeing Commercial Airplanes, I 
am not allowed to bring my laptop to work. 
Now I have a seperate workstation in my 
office at home and have it hooked up to a 
Disk Video Interface. (I got it cheap!) I've 
increased the RAM to 96K and have 2 drives. 
Following are some of the specific uses I now 
have for the Model 100 and CoCo working to- 
gether and some of the advantages. 

I. J From a telecommunications point of view, 



using the laptop for all these tasks has def- 
inite advantages. Whether I am at home or 
away, I can always check my electronic mail 
boxes, attend on-line conferences, download 
programs and files for either machine, and 
avoid the limitation of needing to be home at 
the CoCo. 

II. ) One of the niftier little file manage- 
ment programs I use for a variety of uses on 
the CoCo is JULIE THE MOUSE. This freeforra 
file manager has the ability to output JULIE 
file formats to an ASCII file that can be 
sent via modem. Anyone having the program can 
download the file. Another way the laptop 
assists in JULIE applications is that I do 
not have to be home at the CoCo to initiate a 
new file. I can type in my records on the 
M-100 in JULIE format. Then when I return 
home, I can upload the file to the CoCo. 

III. ) One of the most unfortunate missing ap- 
plications for the CoCo is that of an out- 
liner. If you have never heard of one or used 
one, you don't know what you're missing! I 
use a model 100 program called IDEA! by 
Traveling Software INC. It is a program I 
cannot live without. In any case, I spool the 
IDEA! file formatted to a RAM file and then 
upload it to the CoCo and BUSINESS WRITERtm 
for cleanup and final formatting, 

IV. ) I still use LUCID spreadsheet and move 
the files up to the CoCo when necessary. 

THE FUTURE 

Hopefully, the capabilities and uses for 
the CoCo / Model 100 interface will increase. 
I have a programmer friend in Seattle who has 
an excellent client mailing list program he 
wrote for his CoCo. He also has a Model 100 
so he wrote a model 100 version of his mail- 
ing program and is working now on a method to 
allow the files to be read by either machine. 
He has also developed a special null modem 
cable that "tricks" the CoCo into thinking 
that the Model 100 is a printer. This allows 
him to send data files to the Model 100 from 
CoCo BASIC without the use of a terminal 
program. 

And finally, the is another undeveloped 
use for this setup that already exists be- 
tween the Model 100 and the PC compatibles. 
This is the ability to have a "host program" 
that allows the laptop user to call up his 
desktop from a remote location and actually 
run PC programs. This would be an excellent 
project for a talented CoCo programmer!! If I 
could "run" CoCo programs from a remote lo- 
cation using my laptop, it would be a users 
dream come true! 

If you are a CoCo user who has a need for 
some of these applications and abilities, a 
Model 102 laptop might not be a bad invest- 
ment. You might want to do it just for the 
fun! If you're a wife who considers your- 
self a "CoCo Widow", consider yourself lucky! 
Think how it could be if the darn CoCo 



followed you no matter where you went!. Ask 
my wife, she used to go crazy because I'd 
pack up my Model 100, a 360K disk drive, and 
a thermal printer and take it everywhere we 
go! All of this stuff runs on batteries and 
fits in a briefcase. But you work it out - 
I'm not a marriage counselor. 

POKE 113,0: EXEC40999 



Finally 



An answer for America's dying ieens! 

For your free copy of this dynamic and 
powerful book, calf us today at 
1-800-VICTOnY . 




Also; 

See and hear young people who have 
already found the answer at 
Freedom Village, USA in Lakemont, N.Y. 

Check your local Christian 
radio and television stations for the 
Victory Today program. 
For more information write 
Freedom Village, USA Lakemont, NY 14857 



. VIP Database 1.1 

"ONE OF THE BEST" JUL '84 "RAINBOW 

VIP Database has all the features of VIP Database III 
I described elsewhere in this magazine except the 
•screen widths are 51, 64 & 85. Screen colors are 
black, green and white, double clock speed and 
Spooler are not supported. Even so, VIP Database is 
the most complete database for the CoCo 1 & 2! 
Version 1.1 has FASTER and more RELIABLE disk 
access and single spaced reports. DISK $49.95 



VIP Database owners: upgrade to VIP Database 1 .1 
for $5 + $3 S/H. Send only original disk and $8 total. 



VIP Writer 1.1 

RATED "BEST" IN SEPT '88 "RAINBOW" 

VIP Writer has all the features of VIP Writer III 
described elsewhere in this magazine except the 
screen widths are 32, 51, 64 & 85. Screen colors are 
black, green & white, double clock speed is not 
supported, Spooler and menus are unavailable 
because of memory limitations. Even so, VIP Writer 
is the BEST word processor for the CoCo 1 & 2! 
Version 1.1 includes the configuration/ printer 
installation program and RGB Hard Disk support. 
Available thru Radio Shack Express Order #90-141. 
Includes VIP Speller 1 .1 DISK $ 69.95 



VIP Writer owners: upgrade to VIP Writer 1 .1 for $15 
+ $3 S/H. Send only ORIGINAL disk and $18 total. 
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Dear Editor: 

Since SD Enterprises has taken over the 
VIP line of Color Computer software we have 
uncovered a probj em with the way some of the 
VIP programs work with slower disk drives. It 
seems that the VIP Software does not allow 
sufficient time for some disk drives to come 
up to speed before reading or writing data. 

This problem lias been totally solved by 
restoring the delay built into RSDOS within 
the VIP Software. The VIP Writer III version 
2.0 and VIP Database III do not have this 
problem . 

New versions of the original VIP Writer, 
Speller, Database and Disk-Zap for the CoCo 1 
and 2 with this enhancement are available for 
a small fee. These new versions also add 
additional features. Please see our ads for 
more details. 
Paul Anderson 
S D Enterprises 

Thanks Paul for this updated information , 
Our readers are urged to watch for an updated 
review of VIP Writer TIT Version 2.0 

Dear Mr. Paul: 

My compliments to you on the direction you 
are taking CoCo Clipboard! You're doing a 
splendid job. 

; I was especially interested in Boisy 
Pitre's article "Modular Programming". 

Excellent! It should be emphasized that 
regardless of what language you're using for 
programming (and this includes data-bases and 
spreadsheets), modular programming makes life 
much easier on all concerned and reduces 
logical programming errors. 

One suggestion I'd like to make regarding 
line numbers and interpreted Basics such as 
RS Basic. A significant improvement in speed 
can be obtained if the program organization 
suggested is altered. Place initialization 
statements at the end of the program and 
frequently used subroutines at the beginning 
of the program in the order of frequency of 
use. Put the main module somewhere in the 
middle. Subroutines used infrequently may be 
placed between the main module and the 
initialization statements. The first line of 
the program would contain only pclear and 
pmode statements, as required, immediately 
followed on the same line by a goto (Init- 
ialization Module) at the tail of the 
program. If the modular concept is carried to 
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its limit, the main module will consist only 
of "gosub" statements. 

This speed advantage (or loss) is due to 
the nature of most interpreted basics. Every 
time a line number is called, the interpreter 
goes back to the first line number, jumps to 
that line number, calculates the "distance" 
to the next line number, etc. until it 
reaches the desired line number. Putting 
initialization routines and other seldom used 
routines at the beginning of the program only 
slows everything down. 

A tip regarding remarks. As urged by Mr. 
Pitre, use them liberally. Frankly, if 1 
didn't have remarks, I wouldn't know what I 
did five minutes ago. But remarks slow down a 
program (have to step through those line). A 
better practive is to save and print a copy 
of the program after debugging. The delete 
all the remarks and renumber the line numbers 
stepping the line numbers by 1. This reduces 
the size of the program drastically and fur- 
ther speeds execution. If you want to make 
changes, they are usually more easily made to 
the original program followed by the delete 
and renumber process. 

Just my two cents - hope it helps. Again, 
keep up the excellent work. 

Ed Gresick 
Del mar Co. 
Middleton, DE 

As many of you may remember it was Just 
one year ago that we ran an article called 
"The Dream Machine" which featured Ed's CoCo 
Computer system and how it was used to run 
his Radio Shack Franchise store. That issue 
is still available in reprint form. 

In addition Ed has become one of our 
biggest supporters and Joined with Darlene 
and myself - and Jim DeStafeno at the Phila- 
delphia Area Computer Society CoCo meeting in 
September . Ed has many years of programming 
experience and if you're in the Middleton 
Delaware area stop by and say hi to Ed and 
watch his CoCo business system go! 

To: Mike Dooley: 

I have been reading your Ham radio column, 
and I hope we will get some new interest in 
Ham radio from the computer people reading 
the magazine. 

Anyhow perhaps you can mention a few 
things in your column: 

1) The ARRL has a program exchange ser- 
vice, for an SASE they will send you a 



listing. Readers should write to the ARRL, 
Dept. PX, 225 Main St., Newington, CT . 06111. 
Include the SASE and ask for a list of 
programs . 

2) For Packet Radio try "Auto-Term" 

3) Check out STV pictures, no interface 
receive only using Graphicom. 

There is also a book from Radio Shack 
entitled "Electronic Programs for Circuit 
Designs", I don't have the catalog number but 
it only costs $4.95 and is a great bargain. 

I keyed in the ARRL Dept. PX programs, 
found out 2 of them have errors in them, as 
well as the programs from the Radio Shack 
book. I got the CoCo for Ham radio purposes 
and enjoy using it in the shack with the 
radio and as a stand alone computer. 

73's 
Dave 

(From Mike Dooley) Thanks for the letter 
and all of the good information! I'll be 
checking out the ARRL 's program exchange 
along with the other programs you mentioned . 
I got my CoCo for the same reason as you. I 
kept finding all of these neat inter faceless 
programs for the CoCo and had to try them! 
I'll be covering as many as possible in the 
upcoming months (bi-months?) along with 
listings to be typed in. Hang in there, Dave 
. . . Ham Radip is growing! 

Dear Publisher: 

Enclosed please find a check for the back 
issues mentioned in your flyer. 

If the magazine is as good as you say it 
is you can expect to see a subscription or 
two from this part of the country. I took 
your letter to our local CoCo club meeting to 
see what interest there would be. Everyone 
was enthusiastic but skeptical. Sure hope 

this is the POT OF GOLD at the end of the 
RAINBOW. A lot of us are getting tired of the 
CoCo being thought of as a kid's toy! 

Thank you in advance for what we hope will 
be a shot in the arm for the CoCo Community 
in the Atlanta area. 

Yours 

Alan R. Dages 
Stone Mountain, GA 

Dear Alan: Thanks for the support from your 
part of the country. We're working hard to 
promote the CoCo as a serious computer and 
our growing subscription base of over 800 
PAID is the proof. We can always use more so 
please spread the word! 

Dear Ted and Darlene: 

Enclosed is a money order for another 
year of your much needed magazine. 

I recently bought Multi-Vue, and am STILL 
having trouble trying to revise the "boot- 
list" file, so that I may take advantage of 
my 720K drive. Bob van der Poel stated in his 
article "New Boots" (July/August '88) that it 
took him about an hour trying to make his 



custom "bootlist". That would be Wonderful if 
that's all it took. Being "not-so-affluent" 
with OS-9, I've been working on this problem 
for a good solid 96 hours total, and am still 
messing with it. He's right - much too much 
HAS been written on this subject. So much, in 
fact, that there is no ONE place a person can 
go to for in-depth instruction. 

Another thing that nobody seems to be 
willing to fully explain, is if I can use the 
720K drive (now drive 2) as the default 
drive . 

Anyway, keep those issues coming, and I'll 
continue pounding away, and maybe if I hit 
all the right keys in the correct order one 
day, all this will seem foolish to me! 

Thank You 
Joe Arntz 
Poughkeepsie , NY 

Well Joe, here's your letter and I hope 
our readers will respond quickly to your 
needs. A source you might want to check out 
is the OS-9 SIG on CompuServe. I've received 
a lot of help and information on CIS and 
perhaps we will get one of the OS9 experts to 
be our on line guests during our monthly 
conferences . 



Well I wish we had more space for letters 
this month. As usual we love to hear from 
you by phone, letter or on CIS. 




The VIP Integrated Library 1.1 combines all six popular VIP programs - Writer 
1 .1 , Speller 1.1, Calc, Databasel .1 , Terminal and Disk-Zap 1 .1 - into one program 
on one disk. The program is called VIP Desktop. From the desktop you have 
instant access to word processing with a spelling checker always in attendance, 
data management with mailmerge, spreadsheet financial analysis, telecommuni- 
cations and disk maintenance. Just move the hand to the volume on the bookshelf 
and the application is there. 64K req'd. $149.95 + $4 S/H US, $5 Canada, 
$10 Foreign .VIP Library is available thru Radio Shack Express O rder #90-213. 

VIP Integrated Library owners: upgrade to the VIP Integrated Ubrary 
1.1 for $25 + $3 S/H. Send only ORIGINAL disk and $28 Total. 

SD ENTERPRISES 

(503) 663-2865 P. O. BOX 1233. Gresham, OR. 97030 
Non VIP Library orders add $3 for shipping in USA, Canada $4, 
Foreign $6. COD orders add an additional $2.25. Personal checks 
allow 3 weeks for delivery. All other orders shipped the same day. 
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VIP Database III 0 

"...a remarkable job in creating a nicely updated version of a tried and true CoCo 
database. ...this program just roars! Database III. ..a high powered productivity 
worker in your home or office" -CoCo Clipboard Sept. 1988 



✓ Built-in mailmerge prints form letters & mailing labels! 
%/ Print spooler lets you print while you enter more data. 

✓ Stores 558 records of 256 bytes on a 1 disk system. 

✓ Multi-criteria search with up to 16 relational keys. 

or descending alphabetical or numeric order. 
Records can be searched for specific entries 
using multiple search criteria. The built-in mail- 
merge lets you sort and print mailing lists, print 
form letters, address envelopes - the list is 
endless. The built-in MATH PACKAGE even 
performs arithmetic operations and updates 
other fields. VIP Database 111 also has a print 
spooler and report generator with unlimited print 
format capabilities including embeddable 
control codes for use with ALL printers. 

DISK £69.95 



✓ Supports 40, 64 and 80 column hardware screen. 

%/ Separate text and highlight colors for easy data entry. 

✓ Built-in floating point MATH package. 

✓ IN-MEMORY sort of all records for maximum speed. 

VIP Database III features selectable screen 
displays of 40, 64 or 80 characters by 24 lines 
with choice of 64 foreground, background, hilite 
and cursor colors for EASY DATA ENTRY. It 
uses the CoCo 3's hardware screen and double 
clock speed to be the FASTEST database 
available! VIP Database ill will handle as many 
records as will fit on your disks and is structured 
in a simple and easy to understand menu 
system with full prompting for easy operation. 
Your data is stored in records of your own 
design. All files are fully indexed for speed and 
efficiency. IN-MEMORY SORT of records is 
LIGHTNING FAST and provides for easy listing 
of names, figures, addresses, etc., in ascending 



VIP Database owners: Upgrade to the VIP Database III for 
$39.95 + $3 S/H. Send ORIGINAL disk and $42.95 total. 



VIP Integrated Library 

mMraww /Writer Database Enhanced 

The VIP Library /WDE combines all six popular 
VIP application programs - VIP Database III, VIP 
Writer III, VIP Speller 1.1, VIP Calc, VIP 
Terminal and VIP Disk-ZAP 1.1 - into one 
program on one disk! The program is called VIP 
Desktop. From the desktop you have instant 
access to word processing with a spelling 
checker always in attendance, data 
management with mail merge, spreadsheet 
financial analysis, tele-communications and 
disk maintenance. * 



IvirI 






| Library 






ft . 

UIP Desktop 
©I98S 

SDE 


| E£9 



Merry Christmas 



DISK $169.95 



SIE) Enttmpimsies 

03) 663-2865 ^PQB 1233 Gresham. OR 97030 

Non VIP Library orders add $3 for shipping and handling in USA. Canada $4. Foreign $6. COO orders 



add an additional $2.25 Checks allow 3 weeks (or delivery. All other orders are shipped the same day. 



For VIP Library shipping please add $4 USA. $5 Canada. $10 Foreign. 

VIP Library owners: Upgrade to the VIP Library /WDE for 
$89.90* + $3 S/H. Send ORIGINAL disk and $92.90 total. 

* Future VIP Library upgrades available at reduced cost. 
All products run under RSDOS and are not copy protected. 



VIP Writer III 2.0 

495 K Total Text Space - KASY 4 Color M E N U S 
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MORE SCREEN DISPLAY OPTIONS 

VIP Writer III offers mure screen width options -all with 24 lines 
and actual lower case letters using the CoCo 3's hardware 
display. It runs at double clock speed and has 4-color menus 
making VIP Writer III FAST and EASY to use! You can choose 
foreground, background, hilite and cursor colors from up to 64 
hues. Color can be turned ON or OFF for the best possible 
display using a monochrome monitor or TV sot. VIP Writer III has 
a built in on-line context sensitive help facility to display 
command usage in easy to read colored windows. 

( I STOMIZER & PRINTER INSTALLER 

VIP Writer III comes wrth a configuration / printer installation 
program which lets you customize VIP Writer III to suit your own 
liking. You can set screen width and colors as well as margins 
and more. You can also install your own printer and set interface 
type (serial, parallel or J&M). baud rate, line feeds, etc. Once 
done, you never have to enter these parameters again! VIP 
Writor III will load n' qo with your custom configuration every time! 

ASCII TEXT FILE STORAGE 

VIP Writer III creates ASCII text files which are compatible with 
all other VIP Programs as well as othor programs which use 
ASCII files. You can use VIP Writer III to even type BASIC 
programs! There is a 48K text buffer (438K in a 512K CoCo 3) and 
disk file linking allowing virtually unlimited text space. VIP Writer 
III works with up to 4 disk drives and lets you display directories 
and froo space as well as roname or kill disk files. In addition VIP 
Writor III supports double sided drives using RGB-DOS in ROM 
and is 100% compatible with RGB Computer Systems HARD disk. 

"...High powered software for the CoCo3 ...Fast, 
easy to use. ..a true bargain for the serious CoCo user" 
-CoCo Clipboard MARCH 1988 



POWERFUL EDITING FEATURES 

VIP Writer III has a full featured screen editor which can be used 
to edit text with lines up to 240 characters long with or without 
automatic word wrap around. You can select type-over mode or 
insert mode. There is even an OOPS command to recall a 
cleared toxt buffer. Other editing features include: Type-ahead • 
typamatic koy repeat and key beep for flawless text entry • ond 
of lino boll • full four way cursor control wrth scrolling • top of 
textfiie • bottom of toxtfilo • page up • page down • top of screen • 
bottom of screen • boginning of line • end of line • left one word • 
right one word • DELETE character, to beginning or end of line, 
word to the left or right, or entire line • INSERT character or line • 
LOCATE and/or CHANGE or DELETE single or multiple 
occurrence using wildcards • BLOCK copy, move or delete with 
up to TEN simultaneous block manipulations • TAB key and 
p'onr-rrrnablo Ian stops • word count • I ne restore • tlreu 
PROGRAMMABLE FUNCTIONS to perform tasks such as auto 
column creation and multiple copy printing. 



AUTOMATIC TEXT FORMATTING 

VIP Writer III automatically formats your text for you or allows 
you to format your text in any way you wish. You can change the 
top. bottom, left or right margin and page length. You can set 
your text flush loft, conter or flush right. You can turn right hand 
justification on or off. You can have headers, footers, page 
numbers and TWO auxiliary lines which can appear on odd. even 
or all pagos. You can also select the line on which they appear! 
You can even change the line spacing! Parameters can be 
altered ANYWHERE within your text! 



"In the beginning there was VIP Writer and users 
saw that it was good, But it's not the best anymore. 
There's a new word processor to claim the 
crown... VIP Writer III -Setting the Standard" 
RAINBOW Sept. 1988 



PREVIEW PRINT FORMAT WINDOW 

VIP Writer III features an exclusrve format window which allows 
you to preview your document BEFORE PRINTING IT! You are 
able to move up, down, left and right to see centered and |ustified 
text, margins, page breaks, broken paragraphs, orphan lines etc 

PRINTING VERSATILITY 

VIP Writer III prints TWICE as fast as any other CoCo word 
processor! It supports most serial or parallel printers using J&M 
JFD CP or Rainbow interface and gives you the ability to solect 
baud rates from 110 to 19,200. You can imbod printer control 
codes anywhere in your text file EVEN WITHIN JUSTIFIED TEXT! 
VIP Writor ill also has TWENTY programmable printer macros 
which allow you to easily control all of your printers capabilities 
such as bold, underline, italics and superscript using simplo key 
strokes. Other features include: multiple copy printing • single 
sheet pause • add line feeds • print pause to chanqe print wheel. 

BUILT IN PRINT SPOOLING 

Save up to $150 on a print spooler because VIP Writer III has a 
built in print spooler with a 57,000 character buffer which allows 
you to print ono document WHILE you are editing or proof reading 
another. You donl have to wait until your printer is done before 
starting another job! 

50,000 WORD SPELLING CHECKER 

VIP Writor III includes VIP Speller AT NO ADDITIONAL COST! 
VIP Spoiler checks text for misspelled words and has a 50,000 
word dictionary that can be added to or edrted. 

QUALITY DOCUMENTATION 

VIP Writer III comes with a well written 125 page manual which is 
Laser printed, not dot-matrix like the competition. It includes a 
tutorial, glossary of terms and examplos for the beginner as well 
as a complete index' VIP Writer III is truly the BEST you can buy 

Includes VIP Spellerl .1 . DISK $79.95 



VIP Writer owners: Upgrade to the VIP Writer III 2.0 for 
$49.95 + $3 S/H. Send ORIGINAL disk and $52.95 total 

SI) lEHTIEJiPlRnSlBS 

®(503) 663-2865 [ *-PQB 1233 Gresham. OR 97030 

'or.' I- 1 1 v >■>- »■ - t 3hpc % ate tv. r-1 v - •' ~ : . ■ i ia U Foreion $6 COD 0fd*f5 
add ai addtoial $2 2S Chedts ailow 3 lor do rvery All c"*ier orders are shipped trw sanw day 



Writer III or Library /W owners Upgrade to the VIP Writer III 
2.0 for $10 + $3 S/H. Send ORIGINAL disk and $13 total. 
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KEN-TON ELECTRONICS PRESENTS 



REAL S.C.S.I. INTERFACE -AND- THE DUAL RS-232 PAK 




HARD DRIVE INTERFACE 
$89 or $119(with RTC) 



DUAL COMM BOARD 
$74(Single) $89(Dual) 



PAK 
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